home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / tls / tls001.rnotes < prev    next >
Text File  |  1994-09-02  |  130KB  |  6,150 lines
  1. To: TLS001 experimenters
  2.  
  3. These notes were written for the version of the X11R4 Extended
  4. Feature Supplement which includes Update G to SCO Open Desktop.
  5. Much of what is here applies to the TLS001 cut of the R4 server, but
  6. not all.   Use at your own risk.
  7.  
  8.  
  9.  
  10.  
  11.                       (r)
  12.               SCO Open Desktop    X11R4
  13.  
  14.  
  15.  
  16.              Extended Feature Supplement
  17.  
  18.  
  19.  
  20.             Release    and Installation Notes
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.             The Santa Cruz Operation, Inc.
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                     - 1     -
  57.  
  58.  
  59.  
  60.  
  61.     c 1986 - 1991 The Santa Cruz Operation, Inc.  All rights reserved.
  62.  
  63.     No part of this publication    may be reproduced, transmitted,    stored in
  64.     a retrieval    system,    nor translated into any    human or computer
  65.     language, in any form or by    any means, electronic, mechanical, mag-
  66.     netic, optical, chemical, manual or    otherwise, without the prior writ-
  67.     ten    permission of the copyright owner, The Santa Cruz Operation, Inc.,
  68.     400    Encinal, Santa Cruz, California, 95061,    USA.  Copyright    infringe-
  69.     ment is a serious matter under the United States and foreign Copyright
  70.     Laws.
  71.  
  72.     The    copyrighted software that accompanies this manual is licensed to
  73.     the    End User only for use in strict    accordance with    the End    User
  74.     License Agreement, which License should be read carefully before com-
  75.     mencing use    of the software.  Information in this document is subject
  76.     to change without notice and does not represent a commitment on the
  77.     part of The    Santa Cruz Operation, Inc.
  78.  
  79.     The    following legend applies to all    contracts and subcontracts
  80.     governed by    the Rights in Technical    Data and Computer Software Clause
  81.     of the United States Department of Defense Federal Acquisition Regula-
  82.     tions Supplement:
  83.  
  84.     RESTRICTED RIGHTS LEGEND:  Use, duplication, or disclosure by the
  85.     government is subject to restrictions as set forth in subparagraph (c)
  86.     (1)    (ii) of    the Rights in Technical    Data and Computer Software Clause
  87.     at DFARS 52.227-7013.  The Santa Cruz Operation, Inc., 400 Encinal
  88.     Street, Santa Cruz,    California 95061, U.S.A.
  89.  
  90.  
  91.     SCO, the SCO logo and The Santa Cruz Operation are registered trade-
  92.     marks of The Santa Cruz Operation, Inc. in the U.S.A. and other coun-
  93.     tries.
  94.     ALR    is a trademark of Advanced Logic Research, Inc.
  95.     AT&T is a trademark    of American Telephone &    Telegraph Information Sys-
  96.     tems.
  97.     COMPAQ is a    registered trademark of    Compaq Computer    Corporation.
  98.     Cornerstone    is a registered    trademark of Cornerstone Technology.
  99.     Corollary is a registered trademark    of Corollary, Inc.
  100.     GRiD is a registered trademark of GRiD Systems Corporation.
  101.     Hercules is    a registered trademark of Hercules Computer Corporation,
  102.     Inc.
  103.     HP is a registered trademark of Hewlett-Packard Corporation.
  104.     IBM    is a registered    trademark of International Business Machines Cor-
  105.     poration.
  106.     Open Desktop is a registered trademark of The Santa    Cruz Operation,
  107.     Inc.
  108.     Paradise and Paradise VGA are registered trademarks    of Paradise Sys-
  109.     tems Inc.
  110.     Renaissance    Rendition is a trademark of Systems Solutions Inc.
  111.     Texas Instruments is a registered trademark    of Texas Instruments.
  112.     Toshiba is a registered trademark of Toshiba Corporation.
  113.     UNIX is a registered trademark of Unix System Laboratories Inc. in the
  114.     U.S.A and other countries.
  115.     Video Seven    is a trademark of Headland Technology, Inc.
  116.     XENIX, Microsoft, and MS-DOS are registered    trademarks of Microsoft
  117.     Corporation    in the U.S.A. and other    countries.
  118.     X Window System is a trademark of the Massachusetts    Institute of Tech-
  119.     nology.
  120.  
  121.  
  122.                     - 2     -
  123.  
  124.  
  125.  
  126.  
  127.     Xsight is a    registered trademark of    Locus Computing    Corporation.
  128.  
  129.     Document version: 4.1.0d
  130.  
  131.     Date: 19 December 1991
  132.  
  133.  
  134.  
  135.  
  136.                     - 3     -
  137.  
  138.  
  139.  
  140.  
  141.              Contents
  142.  
  143.              Preface   1
  144.                Contents of This EFS  1
  145.                   Software Requirements   2
  146.                   About these Release Notes   2
  147.                   Conventions Used in This Guide   2
  148.  
  149.  
  150.              Chapter 1  Installing the EFS  1
  151.                Before You Install  1
  152.                   Back up the Color Database   2
  153.                   Back up the Font Alias Files   2
  154.                   Back up Keyboard Configuration Files   3
  155.                   Back up the Grafinfo Files   3
  156.                Installation Procedure  3
  157.  
  158.  
  159.              Chapter 2  Configuring the Server  1
  160.                Video Configuration  1
  161.                Adding New Colors to the Server  2
  162.                Adding New Fonts to the Server  3
  163.                Configuring the Server Keyboard  4
  164.  
  165.  
  166.              Chapter 3  Release Information  1
  167.                New Features  1
  168.                   Performance Improvements   1
  169.                   Server Bankswitching   1
  170.                   Dynamically Loadable Graphics Adapter Drivers   1
  171.                   Monitor Information Files   2
  172.                   New Grafinfo File Format   2
  173.                   X11R4 Server Utilities   2
  174.                   New Default Screen Switch Key Sequence   3
  175.                   New Server Command Line Option   3
  176.                   New Color Database   3
  177.                   New Font Database   3
  178.                   New fonts.alias File Format   3
  179.                   X11 Release 4 Server Extensions   4
  180.                   MIT-MAGIC-COOKIE Authorization Protocol   4
  181.                   Standard Colormap Properties   4
  182.  
  183.             Keyboard Configuraton  5
  184.                Xsco.cfg Configuration File   5
  185.                xsconfig Source Files   5
  186.                International Keyboard Support   6
  187.             Running R3 Clients with the Xsco Server  6
  188.             Supported Graphics Adapters  7
  189.                Supported Monitors   21
  190.             Known Limitations  22
  191.                34010-based Graphics Adapter Support   22
  192.                Server Virtual Screen Option   22
  193.                xinit Doesn't Start any Clients   23
  194.                Erratic Lock Keys Behavior   23
  195.                Lost Error Messages   23
  196.                Pointer Does Not Disappear from Merge   23
  197.  
  198.  
  199.           Chapter 4  Creating Moninfo Files  1
  200.             Moninfo Conventions  1
  201.             Monitor Information File Structure  2
  202.             Moninfo Parameters  3
  203.             Sample Moninfo File  4
  204.  
  205.  
  206.           Chapter 5  Creating Grafinfo Files  1
  207.             Introduction  1
  208.             Grafinfo Conventions  2
  209.             Differences Between Xsight and Xsco Grafinfo Files  3
  210.                InitGraphics Procedure Replaced by DATA Specification   3
  211.                Custom Parameter Definitions   3
  212.                Bankswitch MAPTYPE Parameter   3
  213.                PIXRESX and PIXRESY Parameters   4
  214.             Writing a grafinfo File  4
  215.                Upgrading an Existing grafinfo File   5
  216.             Graphics Information File Structure  6
  217.                Comments   7
  218.             Grafinfo Header  7
  219.             Grafinfo Parameters  13
  220.                Parameter Descriptions   15
  221.             Grafinfo Procedures  22
  222.             Grafinfo Commands  22
  223.                Command Descriptions   23
  224.             Sample Grafinfo File  27
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.                     - 1     -
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.                     - 2     -
  353.  
  354.  
  355.  
  356.  
  357.     These Release and Installation Notes document the X11R4 EFS    (Extended
  358.     Feature Supplement)    product.  Use this product with    SCO Open
  359.     Desktop(r) 1.1 with    Update G.
  360.  
  361.     The    software provided in this EFS includes an X11 Release 4    server,
  362.     Xsco, that replaces    the existing X11 Release 3 server, Xsight(r). It
  363.     provides additional    functionality for vendor-specific graphics
  364.     adapters.
  365.  
  366.     The    software contained in this release offers the following    features:
  367.  
  368.        o faster    and improved X display server
  369.  
  370.        o server    support    for IBM(r) XGA and Olivetti EVC-1 graphics
  371.      adapters
  372.  
  373.     *********************************************************************
  374.     NOTE
  375.  
  376.     This EFS does not support EGA graphics adapters or 34010-based graph-
  377.     ics    adapters such as the Compaq(r) AGS, HP IGC, and    Renaissance Rendi-
  378.     tion.  If you need to run an X server with either of these types of
  379.     graphics adapter, do not install this EFS.    The Xsight server included
  380.     in    1.1 supports both EGA and 34010-based graphics adapters.
  381.     *********************************************************************
  382.  
  383.  
  384.     0.1     Contents of This EFS
  385.     The X11R4 EFS consists of the following:
  386.  
  387.        o the Xsco server and related configuration utilities and files
  388.  
  389.        o online    manual pages for the server configuration utilities
  390.  
  391.        o these Release and Installation    Notes
  392.  
  393.     Keep all floppy diskettes until the    next release of     or your operating
  394.     system.  You may need to install or    reinstall the packages if you
  395.     upgrade the    software or hardware on    your system.
  396.  
  397.     0.1.1  Software Requirements
  398.  
  399.     This EFS can be installed on systems running Release 1.1, Update G,    of
  400.     SCO    Open Desktop. The EFS can be also be installed on
  401.      systems running SCO MPX, Update A.
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.                     - 1     -
  418.  
  419.  
  420.     X11R4 EFS  Release and Installation    Notes
  421.  
  422.     0.1.2  About these Release Notes
  423.  
  424.     The    X11R4 EFS Release and Installation Notes are divided into the fol-
  425.     lowing chapters:
  426.  
  427.        o Chapter 1, ``Installing the EFS,'' describes how to install the
  428.      software provided in the X11R4    EFS.
  429.  
  430.        o Chapter 2, ``Configuring the Server,''    describes how to configure
  431.      the server for    different video    systems    and how    to update
  432.      preserved color and font databases created for    the Xsight server.
  433.  
  434.        o Chapter 3, ``Release Information,'' describes features    and
  435.      enhancements specific to this release.
  436.  
  437.        o Chapter 4, ``Creating Moninfo Files,''    describes how to create
  438.      monitor information files for the Xsco    server.
  439.  
  440.        o Chapter 5, ``Creating Grafinfo    Files,'' describes how to create
  441.      graphics information files for    the Xsco server.
  442.  
  443.     0.1.3  Conventions Used in This Guide
  444.  
  445.     This guide uses the    following notational conventions:
  446.  
  447.     bold      represents commands, command options, parameters in files,
  448.           data structures, and special keys    that you press.     For exam-
  449.           ple, xset    -bc is a complete command line that is executed
  450.           when you press <Return>.    <CTL>x means to    hold down the Con-
  451.           trol key and press the x key, then release them.
  452.  
  453.     italics   represents files and directories,    as well    as variables that
  454.           you supply.  For example,    in the command argument
  455.           path:pathname, you replace pathname with an actual pathname
  456.           when you type the    command.
  457.  
  458.     Courier   represents system    responses, excerpts from files,    and pro-
  459.           gramming examples.  For example, the following is    an excerpt
  460.           from a file:
  461.  
  462.            DATA
  463.           {
  464.           XDRIVER     =    "dfb";
  465.           VISUAL      =    "PseudoColor";
  466.           DEPTH          =    8;
  467.           PIXBYTES    =    320;
  468.           PIXWIDTH    =    320;
  469.           PIXHEIGHT   =    200;
  470.           PIXBITS     =    8;
  471.           }
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.                     - 2     -
  484.  
  485.  
  486.  
  487.  
  488.     The    X11R4 EFS installs only    on SCO Open Desktop, Release 1.1, Update G
  489.     systems.  No serialization is required to install this EFS.
  490.  
  491.     0.1     Before    You Install
  492.  
  493.     Installing this EFS    replaces the X11 Release 3 environment on your SCO
  494.     Open Desktop system.  It should not    be removed.  If    you anticipate the
  495.     need to revert to your original system, back up your root directory
  496.     before installing this EFS.
  497.  
  498.     *********************************************************************
  499.     NOTE
  500.  
  501.     If you intend to install the SCO Open Desktop International    Supple-
  502.     ment, install it now. Installing the International Supplement after
  503.     installing this EFS    causes error messages and improper keyboard confi-
  504.     guration. For details on the new international keyboard support, see
  505.     Chapter 3, ``Release Information.''
  506.     *********************************************************************
  507.  
  508.  
  509.     There are several files in your X environment that you may have cus-
  510.     tomized.  This EFS replaces    those files with files that adhere to new
  511.     formats.  The precautions described    in this    section    are recommended    if
  512.     you:
  513.  
  514.        o added colors to the original server color database
  515.  
  516.        o added fonts to    the server or modified the original fonts.alias
  517.      file
  518.  
  519.        o modified your keyboard    configuration files
  520.  
  521.        o added graphics    information (grafinfo) files to    the system
  522.  
  523.     During installation, existing Xsight server    configuration files are
  524.     moved to the /usr/lib/custom/save/xsight directory.     If you    want to
  525.     move the Xsight configuration files    to another filesystem, set your
  526.     CONFIG_SAVE    environment variable to    the desired path before    installing
  527.     this EFS. Your Xsight configuration    files will then    be moved to
  528.     $CONFIG_SAVE/xsight    when you install this EFS.
  529.  
  530.     0.1.1  Back    up the Color Database
  531.  
  532.     This EFS installs a    new color database and color database compiler.
  533.     The    /usr/lib/X11/rgb.txt file is moved during installation.     If you
  534.     added new colors to    the color database supplied with SCO Open Desktop
  535.     Release 1.1, Update    G, you can retrieve your changes from the old
  536.     rgb.txt file and merge them    into the new rgb.txt file.  For    details,
  537.     see    ``Adding New Colors to the Server,'' in    Chapter    2, ``Configuring
  538.     the    Server.''
  539.  
  540.  
  541.  
  542.  
  543.  
  544.     *********************************************************************
  545.     NOTE
  546.  
  547.  
  548.  
  549.                     - 1     -
  550.  
  551.  
  552.     X11R4 EFS Release and Installation Notes
  553.  
  554.     Although the X11 Release 4 version of the rgb color    compiler accepts
  555.     old    rgb.txt    files, the Xsco    server does not    recognize the color data-
  556.     base files generated by the    X11 Release 3 version of rgb, rgb.dat and
  557.     rgb.map.  There is no need to back up these    two files.
  558.     *********************************************************************
  559.  
  560.  
  561.     0.1.2  Back    up the Font Alias Files
  562.  
  563.     The    fonts.alias file format    used by    the Xsco server    has changed since
  564.     the    Xsight server.
  565.  
  566.     When you install the EFS, the following fonts.alias    files are replaced
  567.     by the X11R4 fonts.alias files:
  568.  
  569.        o /usr/lib/X11/fonts/misc/fonts.alias
  570.  
  571.        o /usr/lib/X11/fonts/75dpi/fonts.alias
  572.  
  573.        o /usr/lib/X11/fonts/100dpi/fonts.alias
  574.     After installing the EFS, you can restore your old font aliases.  For
  575.     details, see ``Adding New Fonts to the Server,'' in    Chapter    2, ``Con-
  576.     figuring the Server.''
  577.  
  578.     *********************************************************************
  579.     NOTE
  580.  
  581.     Xsight fonts.alias files are not compatible    with Xsco fonts.alias
  582.     files.  If you created your    own font directories with their    own
  583.     fonts.alias    files, you must    also modify these files    to adhere to the
  584.     new    file format.
  585.     *********************************************************************
  586.  
  587.  
  588.     0.1.3  Back    up Keyboard Configuration Files
  589.  
  590.     When you install this EFS, the following directories are moved to
  591.     /usr/lib/custom/save/xsight:
  592.  
  593.        o /usr/lib/X11/keymaps
  594.  
  595.        o /usr/lib/X11/xsconfig
  596.     A new /usr/lib/X11/xsconfig    directory is installed but the
  597.     /usr/lib/X11/keymaps directory is not replaced.  After installing this
  598.     EFS, you can merge portions    of old keyboard    configuration files into
  599.     the    new keyboard configuration files.  For details,    see ``Configuring
  600.     the    Server Keyboard,'' in Chapter 2, ``Configuring the Server.''
  601.  
  602.     0.1.4  Back    up the Grafinfo    Files
  603.  
  604.     When you install this EFS, the entire /usr/lib/grafinfo directory is
  605.     replaced with graphics information (grafinfo) files    that adhere to a
  606.     new    file format.  After installing the EFS,    you can    merge portions of
  607.     your X11R3 grafinfo    files into the new grafinfo files or update the
  608.     X11R3 grafinfo files to the    new file format, and then re-configure the
  609.     server for your graphics adapter.  For details, see    the following:
  610.  
  611.        o ``Video Configuration'' in Chapter 2, ``Configuring the Server''
  612.  
  613.  
  614.  
  615.                     - 2     -
  616.  
  617.  
  618.  
  619.  
  620.        o ``Upgrading X11R3 Grafinfo Files'' in Chapter 5, ``Creating
  621.      Grafinfo Files.''
  622.  
  623.     0.2     Installation Procedure
  624.  
  625.     The    following procedure installs the X11R4 Server EFS:
  626.  
  627.  
  628.      1.     If you    plan to    install    the SCO    Open Desktop International Supple-
  629.      ment, install it now.
  630.  
  631.      2.     Back up your root directory.
  632.  
  633.      3.     If you    have not yet installed SCO Open    Desktop, Release 1.1,
  634.      Update    G, install it using the    procedures in the SCO Open Desk-
  635.      top, Release 1.1, Update G SCO    Open Desktop Installation Guide
  636.      and Release and Installation Notes.
  637.  
  638.      4.     Log in    as root.
  639.  
  640.      5.     Bring the system to system maintenance    mode after telling your
  641.      users to log off.  To enter system maintenance    mode, type init    1
  642.      and press <Return>.
  643.  
  644.      6.     When asked if you want    to move    the system console to
  645.      /dev/console, confirm by typing y, then pressing <Return>.
  646.  
  647.      7.     Enter the root    password at the    password prompt.
  648.  
  649.      8.     Execute custom    from the command line by typing    custom and press-
  650.      ing <Return>, or from sysadmsh    by making the following    sysadmsh
  651.      selection:
  652.  
  653.           System->Software
  654.  
  655.  
  656.  
  657.      9.     Choose    Install, A New Product,    and Entire Product.  When you are
  658.      prompted to insert the    requested volume, insert the first EFS
  659.      disk, then select Continue.  Eventually, you are prompted again
  660.      for the first floppy volume.
  661.  
  662.     10.     Select    Continue.  It takes a few minutes for the files    to be
  663.      extracted.
  664.  
  665.     11.     Each time you are prompted for    a floppy volume, insert    the
  666.      requested disk    and press <Return>.  There are four disks in the
  667.      EFS disk set.    After several messages indicating the
  668.      installation's    progress, the video configuration menu (vidconf)
  669.      appears.
  670.  
  671.     12.     To select the appropriate video configuration,    select Update,
  672.      then specify the video    adapter, resolution and    color settings,
  673.      monitor type, and (optionally)    a specific console multiscreen for
  674.      the configuration.
  675.  
  676.     13.     Select    Accept.
  677.  
  678.  
  679.  
  680.  
  681.                     - 3     -
  682.  
  683.  
  684.     X11R4 EFS Release and Installation Notes
  685.  
  686.     14.     If desired, select Update and configure other console mul-
  687.      tiscreens.
  688.  
  689.      If you    find no    entries    for your particular graphics adapter and
  690.      monitor, you may be able to configure the server for an
  691.      equivalent device, or you may need to add a new grafinfo or
  692.      moninfo file.    For details, see ``Video Configuration'' in
  693.      Chapter 2, ``Configuring the Server.''
  694.  
  695.     15.     When the vidconf menu returns,    select Quit, then Save the new
  696.      video configuration.  The system reads    the new    graphics informa-
  697.      tion files and    then asks if you want to create    a new kernel.
  698.  
  699.     16.     Type y, then press <Return>.  The system asks if you want to boot
  700.      from the new kernel after the operating system    has been rebuilt.
  701.  
  702.     17.     Type y, then press <Return>.  The system asks if you want to
  703.      rebuild the kernel environment.
  704.  
  705.     18.     Type y, then press <Return>.
  706.  
  707.     19.     When prompted,    press <Return> to exit.
  708.  
  709.     20.     When prompted,    press any key.    The custom menu    returns.
  710.  
  711.     21.     Quit custom.
  712.  
  713.     22.     When the system prompt    returns, type init 6, then press <Return>.
  714.  
  715.     23.     When the boot prompt appears, press <Return>.    You are    given the
  716.      option    of going into multiuser    mode.
  717.  
  718.     24.     Press <CTL>D.
  719.  
  720.      The EFS is now    installed.  Store the X11R4 EFS    distribution media
  721.      in a safe place.  If an accident or a hardware    failure    damages
  722.      the X11R4 EFS files on    your hard disk,    you will need the distri-
  723.      bution    media to re-install the    X11R4 EFS.
  724.  
  725.     To configure the Xsco server, see Chapter 2, ``Configuring the
  726.     Server.''
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.                     - 4     -
  748.  
  749.  
  750.  
  751.  
  752.     This chapter describes Xsco    configuration issues that are not
  753.     addressed in the
  754.      documentation.  The following topics are covered:
  755.  
  756.        o changing the video configuration
  757.  
  758.  
  759.        o adding    new colors to the server
  760.  
  761.  
  762.        o adding    new fonts to the server
  763.  
  764.  
  765.        o configuring the keyboard
  766.     For    information on other configuration subjects, such as localizing
  767.     the    server for different countries,    see the    , Release 1.1, Update G,
  768.     Release and    Installation Notes.
  769.  
  770.     0.1     Video Configuration
  771.  
  772.     This section describes how to configure the    Xsco server for    any of the
  773.     graphics adapters and monitors supported by    the X11R4 EFS.
  774.  
  775.     The    Xsco server provides support for many popular graphics adapters
  776.     through dynamically-linked graphics    adapter    drivers    and graphics
  777.     information    (grafinfo) files. If your graphics adapter is not listed
  778.     in Table 3.1, ``Supported Graphics Adapters,'' in Chapter 3, ``Release
  779.     Information,'' look    for an equivalent adapter in the table.     You may
  780.     be able to use an existing grafinfo    file or    create a new grafinfo file
  781.     based on an    existing file.    For  details about the grafinfo    file for-
  782.     mat, see Chapter 5,    ``Creating Grafinfo Files.''
  783.  
  784.     To run the video configuration program:
  785.  
  786.       1.  Log in as root.
  787.  
  788.  
  789.       2.  Type mkdev graphics, then press <Return>.
  790.  
  791.  
  792.       The Video Configuration screen appears.
  793.  
  794.       3.  Type u to select Update.
  795.  
  796.       The Video Configuration screen appears.
  797.  
  798.       4.  Select the desired adapter type, mode, and monitor model.  If
  799.       you are not sure which monitor model most closely resembles your
  800.       own, select the ``Standard VGA'' model.
  801.  
  802.     *********************************************************************
  803.     NOTE
  804.  
  805.     If you have    a 8514/a-based graphics    adapter    that is    exactly    register-
  806.     compatible with the    IBM 8514/a and is listed as a supported    graphics
  807.     adapter in Table 3.1 in Chapter 3, ``Release Information,''    then you
  808.     can    use one    of the IBM 8514/a modes.  For example, all 8514/a clone
  809.     video adapters support a non-interlaced 1024x768 resolution.  If you
  810.     have an interlaced monitor and your    graphics adapter supports that
  811.  
  812.  
  813.                     - 1     -
  814.  
  815.  
  816.     X11R4 EFS Release and Installation Notes
  817.  
  818.     mode, then select the IBM 8514/a 1024x768 interlaced mode.
  819.     *********************************************************************
  820.  
  821.  
  822.       5.  To assign the    selected graphics adapter mode to a specific con-
  823.       sole multiscreen, select Specify, then select    the desired con-
  824.       sole multiscreen from    the pop-up list.
  825.  
  826.       6.  Select Accept.
  827.  
  828.       7.  If desired, select additional    graphics adapter modes for other
  829.       terminals.
  830.  
  831.       8.  When you have    configured the terminals, type q to quit mkdev
  832.       graphics.
  833.  
  834.       9.  Select Save by pressing s when prompted.
  835.  
  836.     0.2     Adding    New Colors to the Server
  837.  
  838.     The    colors supplied    with this EFS are identical to the colors supplied
  839.     with , Release 1.1,    Update G.  The X11R4 color database consists of
  840.     different files, and is compiled by    a different version of the rgb(X)
  841.     program.  The rgb.txt file format, however,    has not    changed.
  842.  
  843.     When you install this EFS, your old    rgb.txt    is moved to
  844.     /usr/lib/custom/save/xsight/usr/lib/X11/rgb.txt.  If you added new
  845.     colors to the Xsight server    before installing this EFS, you    can add
  846.     your custom    colors to the Xsco server.  To add restore colors from an
  847.     X11R3 rgb.txt file:
  848.  
  849.       1.  Copy the color definitions from the old rgb.txt file to the new
  850.       /usr/lib/X11/rgb.txt file.
  851.  
  852.       2.  Run rgb < rgb.txt.
  853.  
  854.       rgb compiles the text    file and generates two color database
  855.       files:  /usr/lib/X11/rgb.dir and /usr/lib/X11/rgb.pag.
  856.  
  857.       3.  To verify the    contents of the    new color database, use    the
  858.       showrgb utility.  For    details, refer to the showrgb(X) manual
  859.       page.
  860.  
  861.     *********************************************************************
  862.     NOTE
  863.  
  864.     Although the preceding instructions    assume the existence of    a color
  865.     text file named rgb.txt, the filename is not important; rgb    compiles
  866.     the    color database from standard input.  Similarly,    rgb can    generate
  867.     color database files with names other than rgb.dir and rgb.pag.  For
  868.     details on the new rgb program, refer to the rgb(X)    manual page.
  869.     *********************************************************************
  870.  
  871.  
  872.  
  873.  
  874.     0.3     Adding    New Fonts to the Server
  875.  
  876.  
  877.  
  878.  
  879.                     - 2     -
  880.  
  881.  
  882.  
  883.  
  884.     This EFS includes many new fonts and changes the format of the
  885.     fonts.alias    file.  Consequently, X11R3 fonts.alias files cannot be
  886.     used with the X11R4    Xsco server.
  887.  
  888.     The    order of the data fields in each line is reversed.  The    old format
  889.     was:
  890.  
  891.      fontname     alias
  892.  
  893.     The    new format is:
  894.  
  895.      alias          fontname
  896.  
  897.     If you made    copies of your fonts.alias files before    installing this
  898.     EFS, you can add your custom font aliases to the Xsco server.  To
  899.     restore custom font    aliases:
  900.  
  901.       1.  Edit the custom lines    in your    old fonts.alias    files to match the
  902.       new format.
  903.  
  904.       2.  Add the updated lines    to the new fonts.alias files.
  905.  
  906.       3.  Run the mkfontdir program. For details, see the mkfontdir(X)
  907.       manual page.
  908.  
  909.       4.  If the server    is running, run    xset fp    rehash.     Otherwise, the
  910.       new font aliases will    be available the next time you launch the
  911.       server.
  912.  
  913.     0.4     Configuring the Server    Keyboard
  914.  
  915.     For    most purposes, you can configure the Xsco server keyboard with the
  916.     xsconfig.sh    script as described in the xsconfig(X) online manual page
  917.     and    in ``Keyboard Configuration'' in Chapter 3, ``Release Informa-
  918.     tion.''
  919.  
  920.     When you install this EFS, the keyboard map    files in
  921.     /usr/lib/X11/keymaps are removed and the files in
  922.     /usr/lib/X11/xsconfig are replaced by new files.  If you modified your
  923.     xsconfig source files before installing this EFS, you may merge por-
  924.     tions of those files into the new source files in
  925.     /usr/lib/X11/xsconfig.  Because xsconfig.sh    uses the default source
  926.     files supplied in /usr/lib/X11/xsconfig, you are advised to    modify the
  927.     new    source files rather than add old source    files to the xsconfig com-
  928.     mand line.
  929.  
  930.     *********************************************************************
  931.     NOTE
  932.  
  933.     Do not use the old keymap files in the manner described in the  11,
  934.     Update G Release and Installation Notes because all    the keycodes
  935.     greater than 54 are    incorrect in those files.
  936.     *********************************************************************
  937.  
  938.     If you customized any of the the files in the /usr/lib/X11/keymaps
  939.     directory you can preserve your changes with the following steps:
  940.  
  941.       1.  Extract your custom entries from the modified    keymap file.
  942.  
  943.  
  944.  
  945.                     - 3     -
  946.  
  947.  
  948.     X11R4 EFS Release and Installation Notes
  949.  
  950.       2.  Verify that each keycode in your entries has not changed for
  951.       Xsco by comparing the    old keycode assignment with the    new xscon-
  952.       fig source files in the /usr/lib/X11/xsconfig    directory.
  953.  
  954.       3.  To modify the    Xsco server's keyboard map while it is running,
  955.       execute the following    command:
  956.  
  957.           xmodmap -e expression
  958.  
  959.       expression is    a line of text that you    extracted from your old
  960.       keymaps file.
  961.  
  962.       4.  To add your custom key mappings to the server    configuration
  963.       file,    convert    each key mapping expression to the xsconfig source
  964.       file format described    in the xsconfig(X) online manual page, add
  965.       them to /usr/lib/X11/xsconfig/default.kbd, then run xsconfig.
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.                     - 4     -
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.     0.1     New Features
  1018.  
  1019.     The    following are new features of the X11 Release 4    Xsco server.
  1020.  
  1021.     0.1.1  Performance Improvements
  1022.  
  1023.     The    Xsco server, based on MIT X11 Release 4, is faster than    the Xsight
  1024.     server.  This improvement is particularly noticeable during    stippled-
  1025.     fill operations.
  1026.  
  1027.     0.1.2  Server Bankswitching
  1028.  
  1029.     The    Xsco server includes bankswitching drivers to allow access to the
  1030.     entire video memory    of most    VGA graphics adapters. This allows the
  1031.     server to operate in higher    resolutions with more colors.
  1032.  
  1033.     0.1.3  Dynamically Loadable    Graphics Adapter Drivers
  1034.  
  1035.     The    Xsco server includes a dynamic link kit    that allows device drivers
  1036.     to be linked to the    server at runtime.  As a result, drivers for new
  1037.     graphics adapters can be added to the existing server instead of
  1038.     replacing the entire server.
  1039.  
  1040.     Because the    Xsco server only loads the graphics adapter drivers it
  1041.     needs for a    specific system, it requires much less memory.
  1042.  
  1043.     0.1.4  Monitor Information Files
  1044.  
  1045.     The    Xsco server uses monitor information (moninfo) files to    obtain
  1046.     monitor-specific parameters, such as height    and width.  For    details    on
  1047.     moninfo files, see Chapter 4, ``Creating Moninfo Files.''
  1048.  
  1049.     0.1.5  New Grafinfo    File Format
  1050.  
  1051.     The    Xsco  graphics information (grafinfo) file format is different
  1052.     than the Xsight grafinfo file format.  For a complete description of
  1053.     the    new file format, see Chapter 5,    ``Creating Grafinfo Files.''
  1054.  
  1055.     0.1.6  X11R4 Server    Utilities
  1056.  
  1057.     This EFS includes X11R4 versions of    the following server utilities:
  1058.  
  1059.        o bdftosnf
  1060.  
  1061.        o clean_screen
  1062.  
  1063.        o mkfontdir
  1064.  
  1065.        o rgb
  1066.  
  1067.        o showrgb
  1068.  
  1069.        o showsnf
  1070.  
  1071.  
  1072.        o xauth
  1073.  
  1074.  
  1075.  
  1076.  
  1077.                     - 1     -
  1078.  
  1079.  
  1080.     X11R4 Server EFS Release and Installation Notes
  1081.  
  1082.        o xhost
  1083.  
  1084.        o xinit
  1085.  
  1086.        o xmodmap
  1087.  
  1088.        o xsconfig
  1089.  
  1090.        o xset
  1091.  
  1092.        o xswkey
  1093.  
  1094.     0.1.7  New Default Screen Switch Key Sequence
  1095.  
  1096.     To switch away from    the Xsco server    to another console multiscreen,
  1097.     press <CTL><Alt>-Fn.  This is the new default key sequence.     To change
  1098.     the    key sequence, run the xswkey(X)    utility.  For details on xswkey,
  1099.     refer to the online    manual page.
  1100.  
  1101.     0.1.8  New Server Command Line Option
  1102.  
  1103.     The    -analog    and -noanalog options have been    replaced by a single
  1104.     option, -static.  For details, refer to the    Xsco manual page.
  1105.  
  1106.     0.1.9  New Color Database
  1107.  
  1108.     The    X11R4 version of the rgb color compiler    accepts    the same input
  1109.     file format    as the X11R3 version, but it produces two new color data-
  1110.     base files:     /usr/lib/X11/rgb.dir and /usr/lib/X11/rgb.pag.     These
  1111.     files replace the color database files generated by    the X11R3 version
  1112.     of rgb, /usr/lib/X11/rgb.dat and /usr/lib/X11/rgb.map.
  1113.  
  1114.     0.1.10  New    Font Database
  1115.  
  1116.     The    font database included with this EFS increases the number of fonts
  1117.     that were previously available with    the Xsight server.  In addition    to
  1118.     the    six font families (Courier, Helvetica, New Century Schoolbook(r),
  1119.     Symbol, and    Times) included    with the Xsight    server,    the X11R4 font
  1120.     database provides two more font families (Lucida(r)    and the    Clean fam-
  1121.     ily    of fixed-width fonts) and many other special purpose fonts, such
  1122.     as the Greek Symbol    font, the cursor font, the OPEN    LOOKTM cursor and
  1123.     glyph fonts, and Kana and Kanji Japanese fonts.
  1124.  
  1125.     Files for the supported fonts are stored in    the following three sub-
  1126.     directories    to the /usr/lib/X11/fonts directory:  misc, 75dpi,  and
  1127.     100dpi.
  1128.  
  1129.     0.1.11  New    fonts.alias File Format
  1130.  
  1131.     The    fonts.alias files that allow the server    to understand short font
  1132.     names use a    new file format.  For details on the new format, see
  1133.     ``Adding New Fonts to the Server,''    in Chapter 2, ``Configuring the
  1134.     Server.''
  1135.  
  1136.  
  1137.  
  1138.     0.1.12  X11    Release    4 Server Extensions
  1139.  
  1140.  
  1141.  
  1142.  
  1143.                     - 2     -
  1144.  
  1145.  
  1146.  
  1147.  
  1148.     The    Xsco server provides the NonRectangular    Shape Window extension to
  1149.     X, which allows the    creation of arbitrarily    shaped windows.     Window
  1150.     shapes can be defined by a list of rectangles, a bitmap mask, or a
  1151.     combination    of regions.  To    see the    effect of this extension, run
  1152.     xeyes or oclock with the Xsco server.
  1153.  
  1154.     The    Xsco server also provides the X    Test extension to X, which allows
  1155.     clients to send user events    among themselves.  This    extension is usu-
  1156.     ally used for test purposes.
  1157.  
  1158.     *********************************************************************
  1159.     NOTE
  1160.  
  1161.     Developers interested in creating clients that take    advantage of the
  1162.     NonRectangular Shape Window    or X Test extensions can utilize C
  1163.     libraries for these    extensions in SCO Open Desktop Release 1.1
  1164.     Development    System.
  1165.     *********************************************************************
  1166.  
  1167.     The    Xsco server also provides the following    additional extensions.
  1168.     Using these    extensions may result in unanticipated or undesired
  1169.     behavior.  SCO does    not provide developer support for these    exten-
  1170.     sions.
  1171.  
  1172.        o The Multi-Buffer extension provides for smoother movement or ani-
  1173.      mation    on your    display.  Some clients include an option to access
  1174.      this extension.  For example, the ico client uses the -dbl option
  1175.      to activate multi-buffering on    the display.  It is important to
  1176.      note, however,    that using this    extension can result in    a decrease
  1177.      in system performance.
  1178.  
  1179.        o The Shared Memory extension allows images and pixmaps to be
  1180.      shared    between    the Xsco server    and X clients running on the same
  1181.      machine.
  1182.  
  1183.  
  1184.     0.1.13  MIT-MAGIC-COOKIE Authorization Protocol
  1185.  
  1186.     The    Xsco server supports a new authorization protocol, called MIT-
  1187.     MAGIC-COOKIE-1.  This protocol provides tighter security than the
  1188.     security offered by    the xhost utility used by the R3 server.  This
  1189.     protocol only works    with Release 4 clients.     You must continue to use
  1190.     the    xhost utility if you run Release 3 clients.
  1191.  
  1192.  
  1193.     0.1.14  Standard Colormap Properties
  1194.  
  1195.     The    Xsco server now    creates    standard colormap properties. The standard
  1196.     colormap properties    define a set of    commonly used colormaps.  Applica-
  1197.     tions can then share these colormaps and provide a more consistent
  1198.     user interface. Use    the xstdcmap client to create these colormaps and
  1199.     properties.
  1200.  
  1201.  
  1202.  
  1203.  
  1204.     0.2     Keyboard Configuraton
  1205.  
  1206.  
  1207.  
  1208.  
  1209.                     - 3     -
  1210.  
  1211.  
  1212.     X11R4 Server EFS Release and Installation Notes
  1213.  
  1214.     The    Xsco server introduces major changes to    server configuration:
  1215.  
  1216.        o new server configuration file
  1217.  
  1218.        o new source files for the xsconfig utility
  1219.  
  1220.        o new international keyboard support files
  1221.  
  1222.  
  1223.     0.2.1  Xsco.cfg Configuration File
  1224.  
  1225.     The    Xsco server uses a different configuration file    than the Xsight
  1226.     server. The    new configuration file,    .Xsco.cfg, can be placed in
  1227.     /usr/lib/X11 for system-wide use, or individual users can keep custom-
  1228.     ized copies    of .Xsco.cfg in    their home directories.
  1229.  
  1230.     Use    the xsconfig(X)    utility    to create the server configuration file.
  1231.     Use    the xmodmap(X) utitity to modify server    key and    mouse button map-
  1232.     ping when Xsco is running.
  1233.  
  1234.  
  1235.     0.2.2  xsconfig Source Files
  1236.  
  1237.     The    source files supplied in this EFS for xsconfig have been reorgan-
  1238.     ized and renamed to    reflect    the type of configuration data they con-
  1239.     tain.  Button bindings and monitor parameters are no longer    specified
  1240.     in xsconfig    source files.  As a result, source files should    not
  1241.     include ``[buttons]'' or ``[parameters]'' sections.     To modify button
  1242.     bindings use the xmodmap utility. Monitor parameters are now specified
  1243.     in monitor information (moninfo) files, as described in Chapter 4,
  1244.     ``Creating Moninfo Files.''
  1245.  
  1246.     For    convenience, this EFS includes a shell script,
  1247.     /usr/lib/X11/xsconfig/xsconfig.sh, that generates a    configuration file
  1248.     from default source    files.    If xsconfig.sh is run with no command line
  1249.     arguments, it creates /usr/lib/X11/xsconfig/.Xsco.cfg from the follow-
  1250.     ing    source files:
  1251.  
  1252.     /usr/lib/X11/xsconfig/config.txt
  1253.     /usr/lib/X11/xsconfig/default.kbd
  1254.     /usr/lib/X11/xsconfig/misc.kbd
  1255.     /usr/lib/X11/xsconfig/mod.usa.kbd
  1256.     /usr/lib/X11/xsconfig/trans101.kbd
  1257.     /usr/lib/X11/xsconfig/keysymdef.h
  1258.  
  1259.     xsconfig.sh    also accepts command line arguments, but only for use with
  1260.     the     International Supplement.  Details on international keyboard sup-
  1261.     port follow.
  1262.  
  1263.     0.2.3  International Keyboard Support
  1264.  
  1265.     This EFS changes the way you configure the server for international
  1266.     keyboards.    One major change is the    elimination of keymap files, and
  1267.     the    /usr/lib/X11/keymaps directory,    which provided rudimentary inter-
  1268.     national keyboard support for the Xsight server on systems equipped
  1269.     with , Update G without the     international supplement.  Consequently,
  1270.     the    international keyboard configuration procedures    described in the
  1271.     International Supplement cover letter and in the  1.1 Update G Release
  1272.     and    Installation Notes is obsolete.
  1273.  
  1274.  
  1275.                     - 4     -
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.     To configure the Xsco server for non-U.S. keyboards, you must have the
  1282.     International Supplement.  The International Supplement contains a
  1283.     version of the mapkey(M) utility that generates source files for
  1284.     xsconfig based on the same keyboard    configuration file used    by the
  1285.     console. This feature allows you to    create configuration files for
  1286.     specific keyboards that are    consistent with    the console configuration.
  1287.  
  1288.     *********************************************************************
  1289.     NOTE
  1290.  
  1291.     Be sure to install the International Supplement before you install
  1292.     this EFS.
  1293.     *********************************************************************
  1294.  
  1295.  
  1296.     Instead of using a static file from    /usr/lib/X11/keymaps, recommended
  1297.     practice is    to create a new    xsconfig source    file with the following
  1298.     command:
  1299.  
  1300.     mapkey-c csxmap_file keyboard_file > mapkey.kbd
  1301.  
  1302.     csxmap_file    is a ``character set to    X'' file from
  1303.     /usr/lib/X11/csxmaps.  keyboard_file is a file from    /usr/lib/keyboard,
  1304.     and    should be the same file    used by    the console.  This system ensures
  1305.     that the X server keyboard uses the    same keyboard mapping as the con-
  1306.     sole keyboard, providing for a more    consistent interface when using
  1307.     the     operating system and X.
  1308.  
  1309.     0.3     Running R3 Clients with the Xsco Server
  1310.  
  1311.     If you plan    to run certain X11R3 clients, such as the X11R3    version    of
  1312.     xterm, with    the Xsco server, you may need to enable    the server's bug
  1313.     compatibility mode by running xset bc.  This prevents some R3 clients
  1314.     from crashing when they run    with the Xsco server.  For details on the
  1315.     R3 client/R4 server    compatibility issue, refer to the xset(X) manual
  1316.     page.
  1317.  
  1318.     0.4     Supported Graphics Adapters
  1319.  
  1320.     Table 3.1 lists the    graphics adapter modes supported by this EFS.  Not
  1321.     all    graphics adapters support the same combinations    of resolutions and
  1322.     modes.
  1323.  
  1324.     If your graphics adapter is    not listed in Table 3.1, you may still use
  1325.     it if it is    equivalent to a    supported graphics adapter. To determine
  1326.     whether your adapter is supported, consult your graphics adapter docu-
  1327.     mentation for details about    its class (for example,    VGA, XGA, and so
  1328.     on)    and supported resolutions.  If you find    an adapter in Table 3.1
  1329.     that shares    the same class and at least one    common resolution, you can
  1330.     configure Xsco for your adapter but    must first create a new    grafinfo
  1331.     file.  For details on creating grafinfo files, see Chapter 5, ``Creat-
  1332.     ing    Grafinfo Files.''
  1333.  
  1334.     The    list of    adapters in Table 3.1 represents only those graphics
  1335.     adapters that are supported    by graphics information    files in this EFS.
  1336.     Other models may be    supported by writing new grafinfo files.  This
  1337.     list will also be extended as new graphics adapter drivers become
  1338.     available.    Models marked with an asterisk (*) are known to    work, but
  1339.  
  1340.  
  1341.                     - 5     -
  1342.  
  1343.  
  1344.     X11R4 Server EFS Release and Installation Notes
  1345.  
  1346.     have not been thoroughly tested.
  1347.             TABLE 1.  Supported    Graphics Adapters
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.                     - 6     -
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.     _______________________________________________________________________
  1414.     |          |            |                       |
  1415.     |Vendor      |Model        |Mode                   |
  1416.     |_____________|_________________|______________________________________|
  1417.     |          |            |                       |
  1418.     |AST      |VGA Plus        |640x350 16    color               |
  1419.     |          |            |640x480 16    color               |
  1420.     |          |            |800x600 16    color               |
  1421.     |_____________|_________________|______________________________________|
  1422.     |ATI      |VGA Wonder        |640x350 16    color               |
  1423.     |          |            |640x480 16    color               |
  1424.     |          |            |V5    800x600    16 color           |
  1425.     |          |            |V4    800x600    16 color           |
  1426.     |          |            |V3    800x600    16 color           |
  1427.     |_____________|_________________|______________________________________|
  1428.     |ATI      |VGA Wonder Plus  |640x480 16    color -    72 Hz           |
  1429.     |          |            |800x600 16    color -    56 Hz           |
  1430.     |          |            |800x600 16    color -    60 Hz           |
  1431.     |          |            |800x600 16    color -    72 Hz           |
  1432.     |          |            |800x600 256 color - 60 Hz           |
  1433.     |          |            |1024x768 16 color - 60 Hz interlaced  |
  1434.     |          |            |1024x768 16 color (banked)    interlaced |
  1435.     |          |            |1024x768 256 color               |
  1436.     |_____________|_________________|______________________________________|
  1437.     |ATI      |Ultra 512k        |640x480 16    color               |
  1438.     |          |            |640x480 256 color               |
  1439.     |          |            |1024x768 16 color 60 Hz           |
  1440.     |          |            |1024x768 16 color 70 Hz           |
  1441.     |          |            |1024x768 16 color 72 Hz           |
  1442.     |_____________|_________________|______________________________________|
  1443.  
  1444.                (Continued on next page)
  1445.             TABLE 2.  Supported    Graphics Adapters
  1446.  
  1447.                  (Continued)
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.                     - 7     -
  1474.  
  1475.  
  1476.     X11R4 Server EFS Release and Installation Notes
  1477.  
  1478.  
  1479.     _____________________________________________________________
  1480.     |          |             |                 |
  1481.     |Vendor          |Model         |Mode                 |
  1482.     |_____________|__________________|___________________________|
  1483.     |ATI          |Ultra 1M         |640x480 16 color - 60    Hz   |
  1484.     |          |             |640x480 256 color - 60 Hz  |
  1485.     |          |             |1024x768 16 color - 60 Hz  |
  1486.     |          |             |1024x768 16 color - 70 Hz  |
  1487.     |          |             |1024x768 16 color - 72 Hz  |
  1488.     |          |             |1024x768 256 color - 60 Hz |
  1489.     |          |             |1024x768 256 color - 70 Hz |
  1490.     |          |             |1024x768 256 color - 72 Hz |
  1491.     |_____________|__________________|___________________________|
  1492.     |Bull          |ProStation 25i *     |640x350 16 color         |
  1493.     |          |             |640x480 16 color         |
  1494.     |          |             |800x600 16 color         |
  1495.     |          |             |1024x768 16 color         |
  1496.     |_____________|__________________|___________________________|
  1497.     |Chips and    |451 *         |640x480 16 color         |
  1498.     |Technolo-    |             |                 |
  1499.     |gies          |             |                 |
  1500.     |          |             |800x600 16 color         |
  1501.     |_____________|__________________|___________________________|
  1502.     |Chips and    |452 *         |640x480 16 color         |
  1503.     |Technolo-    |             |                 |
  1504.     |gies          |             |                 |
  1505.     |          |             |720x540 16 color         |
  1506.     |          |             |800x600 16 color         |
  1507.     |          |             |960x720 16 color         |
  1508.     |          |             |1024x768 16 color         |
  1509.     |_____________|__________________|___________________________|
  1510.  
  1511.                (Continued on next page)
  1512.             TABLE 3.  Supported    Graphics Adapters
  1513.                  (Continued)
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.                     - 8     -
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.        ________________________________________________________
  1546.        |         |           |               |
  1547.        |Vendor     |Model           |Mode           |
  1548.        |_____________|_________________|_______________________|
  1549.        |Compaq     |Advanced VGA       |630x350 16 color       |
  1550.        |         |           |640x480 16 color       |
  1551.        |         |           |640x480 256    color       |
  1552.        |         |           |800x600 16 color       |
  1553.        |_____________|_________________|_______________________|
  1554.        |Compaq     |Plasma *       |630x400 2 color       |
  1555.        |_____________|_________________|_______________________|
  1556.        |Compaq     |VGA-LCD       |640x480 16 color       |
  1557.        |Compaq     |VGC           |640x350 16 color       |
  1558.        |         |           |640x480 16 color       |
  1559.        |_____________|_________________|_______________________|
  1560.        |Cornerstone     |MCA Dual Page    *  |1600x1280 monochrome   |
  1561.        |_____________|_________________|_______________________|
  1562.        |Cornerstone     |Dual Page       |1600x1280 monochrome   |
  1563.        |_____________|_________________|_______________________|
  1564.        |Cornerstone     |PC 1280       |1280x960 monochrome       |
  1565.        |_____________|_________________|_______________________|
  1566.        |Cornerstone     |Single Page       |768x1008 monochrome       |
  1567.        |_____________|_________________|_______________________|
  1568.        |Eisa Video     |EVC-1           |640x480 16 color       |
  1569.        |         |           |1024x768 16    color       |
  1570.        |         |           |1024x768 256 color       |
  1571.        |_____________|_________________|_______________________|
  1572.  
  1573.                (Continued on next page)
  1574.             TABLE 4.  Supported    Graphics Adapters
  1575.  
  1576.                  (Continued)
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.                     - 9     -
  1606.  
  1607.  
  1608.     X11R4 Server EFS Release and Installation Notes
  1609.  
  1610.  
  1611.     _______________________________________________________________________
  1612.     |          |             |                   |
  1613.     |Vendor      |Model         |Mode                   |
  1614.     |_____________|______________________|_________________________________|
  1615.     |Eizo      |MD-B07 *         |640x350 16 color           |
  1616.     |          |             |640x480 16 color           |
  1617.     |          |             |800x600 16 color           |
  1618.     |_____________|______________________|_________________________________|
  1619.     |Eizo      |Extra/EM (MD-B10) *     |640x350 16 color           |
  1620.     |          |             |640x480 16 color           |
  1621.     |          |             |800x600 16 color           |
  1622.     |          |             |1024x768 16 color interlaced       |
  1623.     |          |             |1024x768 16 color non-interlaced |
  1624.     |_____________|______________________|_________________________________|
  1625.     |Genoa      |6000    Series         |640x480 16 color @ 60    Hz       |
  1626.     |          |             |640x480 16 color @ 70    Hz       |
  1627.     |          |             |640x480 256 color @ 60 Hz       |
  1628.     |          |             |640x480 256 color @ 70 Hz       |
  1629.     |          |             |800x600 16 color @ 60    Hz       |
  1630.     |          |             |800x600 16 color @ 70    Hz       |
  1631.     |          |             |800x600 256 color @ 60 Hz       |
  1632.     |          |             |800x600 256 color @ 70 Hz       |
  1633.     |          |             |1024x768 16 color @ 60 Hz       |
  1634.     |_____________|______________________|_________________________________|
  1635.     |Genoa      |SuperVGA 5000 Series     |640x350 16 color           |
  1636.     |          |             |640x480 16 color           |
  1637.     |          |             |800x600 16 color           |
  1638.     |          |             |1024x768 16 color           |
  1639.     |          |             |1024x768 16 color interlaced       |
  1640.     |_____________|______________________|_________________________________|
  1641.     |Grid      |1530             |640x400 Plasma           |
  1642.     |          |             |640x400 LCD               |
  1643.     |_____________|______________________|_________________________________|
  1644.  
  1645.                (Continued on next page)
  1646.             TABLE 5.  Supported    Graphics Adapters
  1647.  
  1648.                  (Continued)
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.                    - 10     -
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.     __________________________________________________________________________________
  1678.     |               |          |                          |
  1679.     |Vendor           | Model          | Mode                      |
  1680.     |__________________|__________________|___________________________________________|
  1681.     |               |          |                          |
  1682.     |Hercules           | Monochrome      | 720x350 monochrome                  |
  1683.     |__________________|__________________|___________________________________________|
  1684.     |IBM           | VGA          | 320x200 256    color                  |
  1685.     |               |          | 640x350 16 color                  |
  1686.     |               |          | 640x480 2 color                  |
  1687.     |               |          | 640x480 16 color                  |
  1688.     |__________________|__________________|___________________________________________|
  1689.     |IBM           | 8514/A    512k      | 640x480 16 color                  |
  1690.     |               |          | 1024x768 16    color                  |
  1691.     |__________________|__________________|___________________________________________|
  1692.     |IBM           | 8514/a    1M      | 640x480 256    color                  |
  1693.     |               |          | 1024x768 256 color interlaced          |
  1694.     |__________________|__________________|___________________________________________|
  1695.     |IBM           | XGA          | 640x480 2 color                  |
  1696.     |               |          | 640x480 16 color                  |
  1697.     |               |          | 640x480 256    color                  |
  1698.     |               |          | 1024x768 2 color interlaced              |
  1699.     |               |          | 1024x768 16    color interlaced          |
  1700.     |               |          | 1042x768 256 color interlaced          |
  1701.     |__________________|__________________|___________________________________________|
  1702.     |Matrox           | M-WIN-1280      | 1024x768 256 color 60 Hz non-interlaced   |
  1703.     |               |          | 1024x768 256 color 70 Hz non-interlaced   |
  1704.     |               |          | 1280x1024 256 color    60 Hz non-interlaced  |
  1705.     |__________________|__________________|___________________________________________|
  1706.     |Miro datensysteme | miroMagic HR/ISA | 640x480 256    color                  |
  1707.     |               |          | 1024x768 256 color 60 Hz              |
  1708.     |               |          | 1280x1024 256 color                  |
  1709.     |__________________|__________________|___________________________________________|
  1710.     |Miro datensysteme | miroMagic MR/ISA | 640x480 256    color                  |
  1711.     |               |          | 1024x768 256 color 60 Hz              |
  1712.     |__________________|__________________|___________________________________________|
  1713.  
  1714.                (Continued on next page)
  1715.             TABLE 6.  Supported    Graphics Adapters
  1716.  
  1717.                  (Continued)
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.                    - 11     -
  1738.  
  1739.  
  1740.     X11R4 Server EFS Release and Installation Notes
  1741.  
  1742.  
  1743.     _______________________________________________________________________________
  1744.     |               |                |                   |
  1745.     |Vendor           | Model                | Mode               |
  1746.     |__________________|____________________________|______________________________|
  1747.     |               |                |                   |
  1748.     |Orchid Technology | Designer *            | 640x350 16 color           |
  1749.     |               |                | 640x480 16 color           |
  1750.     |               |                | 800x600 16 color           |
  1751.     |               |                | 1024x768 16 color           |
  1752.     |               |                | 1024x768 16 color    Interlaced |
  1753.     |__________________|____________________________|______________________________|
  1754.     |Orchid Technology | ProDesigner II    version    3.x | 640x350 16 color           |
  1755.     |               |                | 640x480 16 color 60 Hz       |
  1756.     |               |                | 640x480 16 color 70 Hz       |
  1757.     |               |                | 640x480 256 color    60 Hz       |
  1758.     |               |                | 640x480 256 color    70 Hz       |
  1759.     |               |                | 800x600 16 color 56 Hz       |
  1760.     |               |                | 800x600 16 color 60 Hz       |
  1761.     |               |                | 800x600 16 color 70 Hz       |
  1762.     |               |                | 800x600 256 color    56 Hz       |
  1763.     |               |                | 800x600 256 color    60 Hz       |
  1764.     |               |                | 800x600 256 color    70 Hz       |
  1765.     |               |                | 1024x768 256 color 45 Hz       |
  1766.     |               |                | 1024x768 256 color 60 Hz       |
  1767.     |__________________|____________________________|______________________________|
  1768.  
  1769.                (Continued on next page)
  1770.             TABLE 7.  Supported    Graphics Adapters
  1771.  
  1772.                  (Continued)
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.                    - 12     -
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.     _______________________________________________________________________________________
  1810.     |               |                |                       |
  1811.     |Vendor           | Model                | Mode                   |
  1812.     |__________________|____________________________|______________________________________|
  1813.     |               |                |                       |
  1814.     |Orchid Technology | ProDesigner II    version    4.x | 640x350 16 color               |
  1815.     |               |                | 640x480 16 color 60 Hz           |
  1816.     |               |                | 640x480 16 color 70 Hz           |
  1817.     |               |                | 640x480 256 color    60 Hz           |
  1818.     |               |                | 640x480 256 color    70 Hz           |
  1819.     |               |                | 800x600 16 color 56 Hz           |
  1820.     |               |                | 800x600 16 color 60 Hz           |
  1821.     |               |                | 800x600 16 color 70 Hz           |
  1822.     |               |                | 800x600 256 color    56 Hz           |
  1823.     |               |                | 800x600 256 color    60 Hz           |
  1824.     |               |                | 800x600 256 color    70 Hz           |
  1825.     |               |                | 1024x768 256 color interlaced 45 Hz  |
  1826.     |               |                | 1024x768 256 color non-inter 60 Hz   |
  1827.     |__________________|____________________________|______________________________________|
  1828.     |Orchid Technology | ProDesigner II    version    5.x | 640x350 16 color @ 60Hz           |
  1829.     |               |                | 640x480 16 color @ 60Hz           |
  1830.     |               |                | 640x480 16 color @ 72Hz           |
  1831.     |               |                | 640x480 256 color    @ 60Hz           |
  1832.     |               |                | 640x480 256 color    @ 72Hz           |
  1833.     |               |                | 800x600 16 color @ 56Hz           |
  1834.     |               |                | 800x600 16 color @ 60Hz           |
  1835.     |               |                | 800x600 16 color @ 72Hz           |
  1836.     |               |                | 800x600 256 color    @ 56Hz           |
  1837.     |               |                | 800x600 256 color    @ 60Hz           |
  1838.     |               |                | 800x600 256 color    @ 72Hz           |
  1839.     |               |                | 1024x768 256 color interlaced @ 45Hz |
  1840.     |               |                | 1024x768 256 color non-inter @ 60Hz  |
  1841.     |__________________|____________________________|______________________________________|
  1842.  
  1843.                (Continued on next page)
  1844.             TABLE 8.  Supported    Graphics Adapters
  1845.  
  1846.                  (Continued)
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.                    - 13     -
  1870.  
  1871.  
  1872.     X11R4 Server EFS Release and Installation Notes
  1873.  
  1874.  
  1875.     ___________________________________________________________________________
  1876.     |               |         |                       |
  1877.     |Vendor           | Model         | Mode                       |
  1878.     |__________________|_________________|_____________________________________|
  1879.     |               |         |                       |
  1880.     |Orchid Technology | ProDesigner/e     | 640x350 16 color               |
  1881.     |               |         | 640x480 16 color 60 Hz           |
  1882.     |               |         | 640x480 16 color 70 Hz           |
  1883.     |               |         | 640x480 256 color 60    Hz           |
  1884.     |               |         | 640x480 256 color 70    Hz           |
  1885.     |               |         | 800x600 16 color 56 Hz           |
  1886.     |               |         | 800x600 16 color 60 Hz           |
  1887.     |               |         | 800x600 16 color 70 Hz           |
  1888.     |               |         | 800x600 256 color 56    Hz           |
  1889.     |               |         | 800x600 256 color 60    Hz           |
  1890.     |__________________|_________________|_____________________________________|
  1891.     |Orchid Technology | ProDesigner IIs | 640x350 16 color 60 Hz           |
  1892.     |               |         | 640x480 16 color 60 Hz           |
  1893.     |               |         | 640x480 16 color 72 Hz           |
  1894.     |               |         | 640x480 256 color 60    Hz           |
  1895.     |               |         | 640x480 256 color 72    Hz           |
  1896.     |               |         | 800x600 16 color 56 Hz           |
  1897.     |               |         | 800x600 16 color 60 Hz           |
  1898.     |               |         | 800x600 16 color 72 Hz           |
  1899.     |               |         | 800x600 256 color 56    Hz           |
  1900.     |               |         | 800x600 256 color 60    Hz           |
  1901.     |               |         | 800x600 256 color 72    Hz           |
  1902.     |               |         | 1024x768 256    color interlaced 45 Hz |
  1903.     |               |         | 1024x768 256    color non-inter    60 Hz  |
  1904.     |               |         | 1024x768 256    color non-inter    70 Hz  |
  1905.     |__________________|_________________|_____________________________________|
  1906.  
  1907.                (Continued on next page)
  1908.             TABLE 9.  Supported    Graphics Adapters
  1909.  
  1910.                  (Continued)
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.                    - 14     -
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.      ___________________________________________________________________
  1942.      |            |            |                    |
  1943.      |Vendor        | Model        | Mode                |
  1944.      |______________|_______________|___________________________________|
  1945.      |            |            |                    |
  1946.      |Paradise        | VGA 1024        | 640x350 16 color            |
  1947.      |            |            | 640x480 16 color            |
  1948.      |            |            | 640x480 256 color            |
  1949.      |            |            | 800x600 16 color            |
  1950.      |            |            | 1024x768 16 color            |
  1951.      |______________|_______________|___________________________________|
  1952.      |Paradise        | VGA Plus        | 640x350 16 color            |
  1953.      |            |            | 640x400 256 color            |
  1954.      |            |            | 640x480 16 color            |
  1955.      |            |            | 800x600 16 color            |
  1956.      |______________|_______________|___________________________________|
  1957.      |Paradise        | 8514/a        | 1024x768 256 color non-interlaced    |
  1958.      |______________|_______________|___________________________________|
  1959.      |Quadram        | Quad VGA *    | 640x350 16 color            |
  1960.      |            |            | 640x480 16 color            |
  1961.      |            |            | 800x600 16 color            |
  1962.      |            |            | 1024x768 16 color            |
  1963.      |______________|_______________|___________________________________|
  1964.      |Sigma Designs | Legend        | 640x480 16 color            |
  1965.      |            |            | 640x480 256 color            |
  1966.      |            |            | 800x600 16 color            |
  1967.      |            |            | 800x600 256 color            |
  1968.      |            |            | 1024x768 16 color    non-interlaced    |
  1969.      |            |            | 1024x768 256 color non-interlaced    |
  1970.      |            |            | 1024x768 256 color interlaced    |
  1971.      |______________|_______________|___________________________________|
  1972.      |STB Systems   | EM-16 *        | 640x480 16 color            |
  1973.      |            |            | 640x480 256 color            |
  1974.      |            |            | 800x600 16 color            |
  1975.      |            |            | 800x600 256 color            |
  1976.      |______________|_______________|___________________________________|
  1977.  
  1978.                (Continued on next page)
  1979.             TABLE 10.  Supported Graphics Adapters
  1980.  
  1981.                  (Continued)
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.                    - 15     -
  2002.  
  2003.  
  2004.     X11R4 Server EFS Release and Installation Notes
  2005.  
  2006.  
  2007.     ___________________________________________________________________________
  2008.     |          |                 |                       |
  2009.     |Vendor      |Model             |Mode                   |
  2010.     |_____________|__________________________|_________________________________|
  2011.     |          |                 |                       |
  2012.     |STB Systems  |Powergraph Ergo (EM-16+)  |640x480 16 color               |
  2013.     |          |                 |640x480 256 color               |
  2014.     |          |                 |800x600 16 color               |
  2015.     |          |                 |800x600 256 color               |
  2016.     |          |                 |1024x768 16 color               |
  2017.     |          |                 |1024x768 256 color           |
  2018.     |_____________|__________________________|_________________________________|
  2019.     |STB Systems  |Extra-EM *             |640x350 16 color               |
  2020.     |          |                 |640x480 16 color               |
  2021.     |          |                 |800x600 16 color               |
  2022.     |          |                 |1024x768 16 color    non-interlaced |
  2023.     |          |                 |1024x768 16 color    interlaced     |
  2024.     |_____________|__________________________|_________________________________|
  2025.     |Tecmar      |VGA/AD *             |640x350 16 color               |
  2026.     |          |                 |640x480 16 color               |
  2027.     |          |                 |800x600 16 color               |
  2028.     |          |                 |1024x768 16 color    non-interlaced |
  2029.     |          |                 |1024x768 16 color    interlaced     |
  2030.     |_____________|__________________________|_________________________________|
  2031.     |Toshiba      |Grid    758 *             |640x400 monochrome           |
  2032.     |_____________|__________________________|_________________________________|
  2033.     |Toshiba      |Grid    Plasma *         |640x400 monochrome           |
  2034.     |_____________|__________________________|_________________________________|
  2035.  
  2036.                (Continued on next page)
  2037.             TABLE 11.  Supported Graphics Adapters
  2038.  
  2039.                  (Continued)
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.                    - 16     -
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.        _______________________________________________________________
  2074.        |         |             |                      |
  2075.        |Vendor         |Model         |Mode                  |
  2076.        |_____________|_______________|________________________________|
  2077.        |         |             |                      |
  2078.        |Trident         |Impact II         |640x480 16 color              |
  2079.        |         |             |640x480 256 color              |
  2080.        |         |             |800x600 2    color              |
  2081.        |         |             |800x600 16 color 56Hz          |
  2082.        |         |             |800x600 16 color 72Hz          |
  2083.        |         |             |800x600 256 color    56Hz          |
  2084.        |         |             |800x600 256 color    72Hz          |
  2085.        |         |             |1024x768 2 color non-interlaced |
  2086.        |         |             |1024x768 16 color              |
  2087.        |         |             |1024x768 256 color          |
  2088.        |_____________|_______________|________________________________|
  2089.        |Trident         |Impact III     |640x480 16 color              |
  2090.        |         |             |640x480 256 color              |
  2091.        |         |             |800x600 2    color              |
  2092.        |         |             |800x600 16 color 56Hz          |
  2093.        |         |             |800x600 16 color 72Hz          |
  2094.        |         |             |800x600 256 color    56Hz          |
  2095.        |         |             |800x600 256 color    72Hz          |
  2096.        |         |             |1024x768 2 color non-interlaced |
  2097.        |         |             |1024x768 16 color              |
  2098.        |         |             |1024x768 256 color          |
  2099.        |_____________|_______________|________________________________|
  2100.  
  2101.                (Continued on next page)
  2102.             TABLE 12.  Supported Graphics Adapters
  2103.  
  2104.                  (Continued)
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.                    - 17     -
  2134.  
  2135.  
  2136.     X11R4 Server EFS Release and Installation Notes
  2137.  
  2138.  
  2139.     _____________________________________________________________
  2140.     |          |              |                     |
  2141.     |Vendor          |Model          |Mode                 |
  2142.     |_____________|_______________|______________________________|
  2143.     |          |              |                     |
  2144.     |Trident      |TVGA 8900      |640x480 16 color             |
  2145.     |          |              |640x480 256 color         |
  2146.     |          |              |800x600 2 color             |
  2147.     |          |              |800x600 16 color    56 Hz         |
  2148.     |          |              |800x600 16 color    72 Hz         |
  2149.     |          |              |800x600 256 color 50 Hz         |
  2150.     |          |              |800x600 256 color 72 Hz         |
  2151.     |          |              |1024x768    2 color             |
  2152.     |          |              |1024x768    16 color non-inter   |
  2153.     |          |              |1024x768    16 color interlaced  |
  2154.     |          |              |1024x768    256 color non-inter  |
  2155.     |          |              |1024x768    256 color interlaced |
  2156.     |_____________|_______________|______________________________|
  2157.     |Verticom     |MX/AT          |640x350 16 color             |
  2158.     |          |              |640x480 16 color             |
  2159.     |          |              |800x600 16 color             |
  2160.     |_____________|_______________|______________________________|
  2161.     |Video Seven  |Fast Write *   |640x350 16 color             |
  2162.     |          |              |640x480 16 color             |
  2163.     |          |              |800x600 16 color             |
  2164.     |_____________|_______________|______________________________|
  2165.  
  2166.                (Continued on next page)
  2167.             TABLE 13.  Supported Graphics Adapters
  2168.  
  2169.                  (Continued)
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.                    - 18     -
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.      ___________________________________________________________________
  2206.      |              |            |                |
  2207.      |Vendor          |    Model        | Mode                |
  2208.      |________________|_________________|_______________________________|
  2209.      |              |            |                |
  2210.      |Video Seven     |    VGA 1024i *    | 640x350 16 color        |
  2211.      |              |            | 640x480 16 color        |
  2212.      |              |            | 800x600 16 color        |
  2213.      |              |            | 1024x768 16 color 56 Hz    |
  2214.      |              |            | 1024x768 16 color 44 Hz    |
  2215.      |              |            | 1024x768 16 color 48 Hz    |
  2216.      |              |            | 1024x768 16 color 65 Hz    |
  2217.      |________________|_________________|_______________________________|
  2218.      |Video Seven     |    VRAM *        | 640x350 16 color        |
  2219.      |              |            | 640x480 16 color        |
  2220.      |              |            | 800x600 16 color        |
  2221.      |________________|_________________|_______________________________|
  2222.      |Video Seven     |    VRAM II        | 640x350 16 color        |
  2223.      |              |            | 640x480 16 color        |
  2224.      |              |            | 640x480 256 color        |
  2225.      |              |            | 640x480 256 color interlaced    |
  2226.      |              |            | 752x410 16 color        |
  2227.      |              |            | 720x540 16 color        |
  2228.      |              |            | 800x600 16 color        |
  2229.      |              |            | 800x600 256 color        |
  2230.      |              |            | 1024x768 16 color        |
  2231.      |              |            | 1024x768 16 color interlaced    |
  2232.      |              |            | 1024x768 256 color        |
  2233.      |              |            | 1024x768 256 color interlaced    |
  2234.      |________________|_________________|_______________________________|
  2235.      |Western Digital |    WD90C11    chipset    | 640x350 16 color        |
  2236.      |              |            | 640x480 16 color        |
  2237.      |              |            | 640x480 256 color        |
  2238.      |              |            | 800x600 16 color        |
  2239.      |              |            | 1024x768 16 color        |
  2240.      |________________|_________________|_______________________________|
  2241.  
  2242.     0.4.1  Supported Monitors
  2243.  
  2244.     The    X11R4 EFS supports the following monitor models:
  2245.  
  2246.        o Acer AcerView 11
  2247.  
  2248.  
  2249.        o Acer AcerView 31
  2250.  
  2251.  
  2252.        o Acer AcerView 31LR
  2253.  
  2254.  
  2255.        o Acer AcerView 33
  2256.  
  2257.  
  2258.        o Acer AcerView 33LR
  2259.  
  2260.        o Acer AcerView 35
  2261.  
  2262.  
  2263.  
  2264.  
  2265.                    - 19     -
  2266.  
  2267.  
  2268.     X11R4 Server EFS Release and Installation Notes
  2269.  
  2270.        o Acer AcerView 37
  2271.  
  2272.  
  2273.        o Acer AcerView 7015
  2274.  
  2275.  
  2276.        o AST Super VGA
  2277.  
  2278.  
  2279.        o AST VGA
  2280.  
  2281.  
  2282.        o Bull Hitachi HM-4319-D
  2283.  
  2284.  
  2285.        o Cornerstone 19    inch
  2286.  
  2287.  
  2288.        o Compaq    Advanced Graphics Color    Monitor    14 inch
  2289.  
  2290.  
  2291.        o Compaq    Advanced Graphics Color    Monitor    16 inch
  2292.  
  2293.  
  2294.        o DEC VRC-16
  2295.  
  2296.  
  2297.        o HP D1194A
  2298.  
  2299.  
  2300.        o HP D1195A
  2301.  
  2302.  
  2303.        o IBM 8514
  2304.  
  2305.  
  2306.        o IBM 8515
  2307.  
  2308.  
  2309.        o JVC GD-H6116VFW
  2310.  
  2311.  
  2312.        o NEC 3D
  2313.  
  2314.  
  2315.        o NEC 4D
  2316.  
  2317.  
  2318.        o NEC 5D
  2319.  
  2320.  
  2321.        o Olivetti 14 inch/356 mm
  2322.  
  2323.  
  2324.        o Sony 1304 (Multi Scan HG)
  2325.  
  2326.     In addition, the server supports other monitors that are functionally
  2327.     identical to one of    the models currently listed above.  If you are not
  2328.     sure which monitor model most closely resembles your own, you can
  2329.  
  2330.  
  2331.                    - 20     -
  2332.  
  2333.  
  2334.  
  2335.  
  2336.     configure the Xsco server for one of the following generic monitor
  2337.     models:
  2338.  
  2339.        o Standard VGA
  2340.  
  2341.        o Other 14 inch
  2342.  
  2343.        o Other 17 inch
  2344.  
  2345.        o Other 19 inch
  2346.  
  2347.     0.5     Known Limitations
  2348.  
  2349.     The    following are known limitations    of the Xsco server.  Where appli-
  2350.     cable, methods are given to    work around them.
  2351.  
  2352.     0.5.1  34010-based Graphics    Adapter    Support
  2353.  
  2354.     This EFS does not provide a    server driver for 34010-based graphics
  2355.     adapters.  In the future, however, server drivers for 34010-based
  2356.     graphics adapters will become available in another supplement.  If you
  2357.     need to use    a 34010-based adapter, use the X11R3 Xsight server
  2358.     included in     Release 1.1, Update G;    do not install this EFS.
  2359.  
  2360.     0.5.2  Server Virtual Screen Option
  2361.  
  2362.     The    -s server option, also known as    the Virtual Screen option, is not
  2363.     implemented    on the Xsco server.  This server option    allowed    you to
  2364.     specify and    display    a screen size that is larger than the screen size
  2365.     supported by your monitor.
  2366.  
  2367.     0.5.3  xinit Doesn't Start any Clients
  2368.  
  2369.     If .xserverrc exists in your home directory, the server starts, but    no
  2370.     clients are    started.
  2371.  
  2372.     0.5.4  Erratic Lock    Keys Behavior
  2373.  
  2374.     If you switch from the server to the console, and then change the
  2375.     status of a    Lock key, such as CapsLock or NumLock, the Lock    keys do
  2376.     not    behave properly.
  2377.  
  2378.     0.5.5  Lost    Error Messages
  2379.  
  2380.     Unless you redirect    standard error,    some error messages can    be lost
  2381.     when the Xsco server enters    graphics mode.
  2382.  
  2383.     0.5.6  Pointer Does    Not Disappear from Merge
  2384.  
  2385.     When you focus in a    DOS Merge window with VGA graphics adapters, the
  2386.     pointer does not disappear completely.
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.                    - 21     -
  2398.  
  2399.  
  2400.  
  2401.  
  2402.     This chapter describes how to write    monitor    information (moninfo)
  2403.     files for monitors supported by the    Xsco server included in    the X11R4
  2404.     Server EFS.     The Xsco server uses moninfo files to determine charac-
  2405.     teristics of monitors for which it is configured.  For details on
  2406.     video configuration, see ``Video Configuration'' in    Chapter    2, ``Con-
  2407.     figuring the Server.''
  2408.  
  2409.     To qualify as a moninfo file, the file must:
  2410.  
  2411.        o contain ASCII text in the moninfo file    format described in this
  2412.      chapter
  2413.  
  2414.  
  2415.        o be named with an .mon extension
  2416.  
  2417.  
  2418.        o reside    in a subdirectory under    /usr/lib/grafinfo/moninfo
  2419.  
  2420.  
  2421.     0.1     Moninfo Conventions
  2422.  
  2423.     Moninfo file-naming    conventions require that the filename end with a
  2424.     .mon extension.  Moninfo files do not reside directly in
  2425.     /usr/lib/grafinfo/moninfo, but in subdirectories named after the moni-
  2426.     tor    vendor.     For example, /usr/lib/grafinfo/moninfo/nec/5d.mon con-
  2427.     tains information about the    NEC 5D monitor.
  2428.  
  2429.     mkdev graphics generates a configuration file,
  2430.     /usr/lib/grafinfo/grafmon, that describes the graphics adapter and
  2431.     monitor combinations you specified.     grafmon includes one entry for
  2432.     each adapter/monitor combination.  The syntax of each grafmon entry
  2433.     is:
  2434.  
  2435.      adapter_vendor.adapter_model:monitor_vendor.monitor_model
  2436.  
  2437.  
  2438.     For    example, the following grafmon file entry specifies a Trident TVGA
  2439.     card running with a    Sony 1304HG monitor:
  2440.  
  2441.      trident.tvga:sony.1304
  2442.  
  2443.     The    Xsco server reads grafmon to determine the pathnames of    the
  2444.     grafinfo and moninfo files that describe the installed graphics
  2445.     adapter and    monitor. Xsco also reads /usr/lib/grafinfo/grafdev to
  2446.     determine which graphics adapter mode information it needs to extract
  2447.     from the specified grafinfo    file.  For details on grafinfo files, see
  2448.     Chapter 5, ``Creating Grafinfo Files.''
  2449.  
  2450.     Do not move    the grafinfo and moninfo files after you run mkdev graph-
  2451.     ics.  If you do, the server    fails to find the files    it needs at run-
  2452.     time.  Similarly, if you do    not follow these moninfo file-naming and
  2453.     location conventions, mkdev    graphics cannot    recognize your files as
  2454.     valid moninfo files.
  2455.  
  2456.  
  2457.  
  2458.     0.2     Monitor Information File Structure
  2459.  
  2460.  
  2461.  
  2462.  
  2463.                     - 1     -
  2464.  
  2465.  
  2466.     X11R4 Server EFS Release and Installation Notes
  2467.  
  2468.     Each moninfo file contains a description of    a single monitor model.
  2469.     Moninfo files contain two types of data:
  2470.  
  2471.        o comments
  2472.  
  2473.      Comments may appear anywhere in the file and must follow C
  2474.      language conventions.    The starting symbol for    a comment is /*
  2475.      and the symbol    for ending a comment is    */.  Comments can span
  2476.      several lines of text.
  2477.  
  2478.     *********************************************************************
  2479.     NOTE
  2480.  
  2481.     Do not nest    comments.
  2482.     *********************************************************************
  2483.  
  2484.  
  2485.        o parameter definitions
  2486.  
  2487.      Parameters are    defined, one per line, with the    following syntax:
  2488.  
  2489.      parameter_name    = value;
  2490.  
  2491.     0.3     Moninfo Parameters
  2492.  
  2493.     When you configure the Xsco    server for a specific monitor, Xsco reads
  2494.     a moninfo file to obtain specific information about    the monitor.  The
  2495.     required information is supplied in    parameter definitions.    Table 4.1
  2496.     describes the parameters required by the graphics adapter drivers sup-
  2497.     plied with this version of Xsco.
  2498.  
  2499.     *********************************************************************
  2500.     NOTE
  2501.  
  2502.     Parameter names are    case-sensitive.
  2503.     *********************************************************************
  2504.  
  2505.  
  2506.              TABLE 1.  Moninfo Parameters
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.  
  2528.  
  2529.                     - 2     -
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.            _______________________________________
  2536.            |Parameter    | Purpose          |
  2537.            |____________|_________________________|
  2538.            |DESCRIPTION    | the text that    appears      |
  2539.            |        | in the mkdev graphics      |
  2540.            |        | monitor list          |
  2541.            |MON_VENDOR    | the monitor vendor      |
  2542.            |        | name.    This string must  |
  2543.            |        | be identical to the      |
  2544.            |        | directory in which the  |
  2545.            |        | moninfo file resides.      |
  2546.            |        | the monitor model. This |
  2547.            |        | string must be identi-  |
  2548.            |        | cal to the moninfo file |
  2549.            |        | filename without the      |
  2550.            |        |              |
  2551.            |WIDTHODEL    | the width, in    millime-  |
  2552.            |        | ters,    of the monitor      |
  2553.            |        | screen          |
  2554.            |HEIGHT    | the height, in millime- |
  2555.            |        | ters,    of the monitor      |
  2556.            |        | screen          |
  2557.            |TYPE    | the monitor type. Legal |
  2558.            |        | values are ``color''      |
  2559.            |        | and ``mono.''          |
  2560.            |____________|_________________________|
  2561.  
  2562.     Future drivers may require parameter definitions other than    those
  2563.     listed in Table 4.1.  Xsco graphics    adapter    drivers    ignore parameter
  2564.     definitions    that they do not specifically require.    This ensures that
  2565.     all    Xsco drivers can use the same set of moninfo files.
  2566.  
  2567.     0.4     Sample    Moninfo    File
  2568.  
  2569.     The    following is a sample moninfo file,
  2570.     /usr/lib/grafinfo/moninfo/ibm/8514.mon:
  2571.  
  2572.      /* IBM    8514-001 monitor */
  2573.  
  2574.      DESCRIPTION = "IBM 8514";
  2575.      MON_VENDOR  = "ibm";
  2576.      MON_MODEL   = "8514";
  2577.  
  2578.      WIDTH                       = 300;
  2579.      HEIGHT                       = 220;
  2580.  
  2581.      TYPE                       = "color";
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.                     - 3     -
  2596.  
  2597.  
  2598.  
  2599.  
  2600.     0.1     Introduction
  2601.  
  2602.     This chapter describes how to create graphics information (grafinfo)
  2603.     files for graphics adapters    supported by the Xsco server included in
  2604.     the    X11R4 Server EFS.  Grafinfo files are typically    written    either by
  2605.     a graphics adapter developer or an X server    developer.  Although sys-
  2606.     tem    administrators should be aware of grafinfo file    management, as
  2607.     described in Administering ODT-VIEW, it is usually not necessary for a
  2608.     system administrator to edit a grafinfo file.
  2609.  
  2610.     Grafinfo files serve two purposes:
  2611.  
  2612.        o to configure the operating system for different classes of graph-
  2613.      ics adapters
  2614.  
  2615.        o to supply graphics adapter parameter values to    the Xsco server    at
  2616.      runtime
  2617.  
  2618.     Configuring    the operating system for a graphics adapter requires a
  2619.     grafinfo file in the appropriate subdirectory; the system administra-
  2620.     tor    then runs mkdev    graphics, as described in ``Video Configuration''
  2621.     in Chapter 2, ``Configuring    the Server.''
  2622.  
  2623.     To qualify as a grafinfo file, the file must:
  2624.  
  2625.        o be named with an .xgi extension
  2626.  
  2627.        o reside    in a subdirectory under    /usr/lib/grafinfo
  2628.  
  2629.        o contain ASCII text in the grafinfo file format    described in this
  2630.      chapter
  2631.  
  2632.     These three    attributes of grafinfo files are described in the follow-
  2633.     ing    sections.
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.                     - 1     -
  2661.  
  2662.  
  2663.     X11R4 Server EFS Release and Installation Notes
  2664.  
  2665.  
  2666.     0.2     Grafinfo Conventions
  2667.  
  2668.     Grafinfo filenames end with    an .xgi    extension.  Grafinfo files do not
  2669.     reside directly in /usr/lib/grafinfo, but in subdirectories    named
  2670.     after the adapter vendor.  The vendor subdirectories contain grafinfo
  2671.     files for graphics adapters    supported by the Xsco server.  For exam-
  2672.     ple, if you    install    a Trident TVGA graphics    adapter, the corresponding
  2673.     grafinfo file is /usr/lib/grafinfo/trident/tvga.xgi.  Because graphics
  2674.     adapters can run in    several    different resolutions (modes), each
  2675.     grafinfo file can include separate descriptions for    all modes possible
  2676.     for    a particular graphics adapter.
  2677.  
  2678.     The    grafdev    file generated by mkdev    graphics contains a list of the
  2679.     graphics adapters currently    installed in the system, and the terminals
  2680.     to which they are assigned.    For example, if    you run    mkdev graphics and
  2681.     assign a Trident TVGA adapter in 640x480, 16 color mode to tty09, the
  2682.     following line appears in /usr/lib/grafinfo/grafdev:
  2683.  
  2684.      /dev/tty09:trident.tvga.svga.640x480-16
  2685.  
  2686.     mkdev graphics also    creates    /usr/lib/grafinfo/grafinfo.def which
  2687.     specifies a    single graphics    adapter    mode.  When you    run Xsco in single
  2688.     user mode, the server reads    grafinfo.def instead of    grafdev.
  2689.  
  2690.     The    Xsco server reads grafdev to determine which grafinfo file to read
  2691.     at runtime.     Do not    move grafinfo files after you run mkdev    graphics;
  2692.     if you do, the server fails    to find    the files it needs at runtime.
  2693.     Similarly, if you do not follow these grafinfo file-naming and loca-
  2694.     tion conventions, mkdev graphics does not recognize    your files as
  2695.     valid grafinfo files.
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.  
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.                     - 2     -
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.     0.3     Differences Between Xsight and    Xsco Grafinfo Files
  2733.  
  2734.     The    differences between the    Xsight and Xsco    servers    are reflected in
  2735.     differences    between    their grafinfo file formats.
  2736.  
  2737.     0.3.1  InitGraphics    Procedure Replaced by DATA Specification
  2738.  
  2739.     In Xsight grafinfo files, parameters were defined in a InitGraphics
  2740.     procedure statement. In Xsco grafinfo files, InitGraphics procedure
  2741.     statements are replaced by DATA statements.     (See the sample grafinfo
  2742.     file at the    end of this chapter.)
  2743.  
  2744.     0.3.2  Custom Parameter Definitions
  2745.  
  2746.     The    parameter definitions required by the Xsco server depend on the
  2747.     installed graphics adapter and the Xsco driver that    supports it.  The
  2748.     Xsco server's runtime link kit allows new graphics adapter drivers to
  2749.     be added to    the server to support new graphics adapters.  New drivers
  2750.     may    require    new grafinfo files, and    may also require different parame-
  2751.     ters to be defined at runtime.  To accommodate future grafinfo files,
  2752.     the    Xsco server only uses parameter    definitions if they are    required
  2753.     by the graphics adapter driver selected while running mkdev    graphics;
  2754.     all    other parameter    definitions are    ignored.  For a    list of    parameters
  2755.     used by the    graphics adapters that the Xsco    server currently supports,
  2756.     see    ``Grafinfo Parameters,'' later in this chapter.
  2757.  
  2758.     0.3.3  Bankswitch MAPTYPE Parameter
  2759.  
  2760.     The    Xsco server includes bankswitching drivers that    allow the server
  2761.     to access a    VGA graphics adapter's entire video memory.  As    a result,
  2762.     the    Xsco server can    render higher resolution graphics and more colors
  2763.     with a given graphics adapter than is possible with    the Xsight server.
  2764.  
  2765.     You    can tell the Xsco which    bankswitching driver to    use for    a specific
  2766.     graphics adapter mode by including the new MAPTYPE parameter in DATA
  2767.     statements in the appropriate grafinfo file.  For details, see
  2768.     ``Grafinfo Parameters,'' later in this chapter.
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.  
  2792.                     - 3     -
  2793.  
  2794.  
  2795.     X11R4 Server EFS Release and Installation Notes
  2796.  
  2797.  
  2798.     0.3.4  PIXRESX and PIXRESY Parameters
  2799.  
  2800.     The    PIXRESX    and PIXRESY parameters are no longer required by the Xsco
  2801.     graphics adapter drivers. The information these two    parameters sup-
  2802.     plied is now derived from the WIDTH    and HEIGHT parameters in moninfo
  2803.     files. For details,    see Chapter 4, ``Creating Moninfo Files.''
  2804.  
  2805.     0.4     Writing a grafinfo File
  2806.  
  2807.     Writing a grafinfo file requires:
  2808.  
  2809.        o using a detailed technical reference guide for    the graphics
  2810.      adapter card
  2811.  
  2812.        o knowing the following aspects of the graphics adapter:
  2813.  
  2814.         - vendor name
  2815.  
  2816.         - model name
  2817.  
  2818.         - class name
  2819.  
  2820.         - number of    pixels horizontally
  2821.  
  2822.         - number of    pixels vertically
  2823.  
  2824.         - number of    colors
  2825.  
  2826.         - base memory address and length
  2827.  
  2828.         - I/O ports    for general/external registers,    attribute,
  2829.           sequencer, color registers, graphics, and    CRTC
  2830.  
  2831.         - number of    adjacent color bits per    pixel
  2832.  
  2833.         - number of    color planes
  2834.  
  2835.         - base physical memory address for the graphics adapter screen
  2836.  
  2837.         - raster interleave    factor
  2838.  
  2839.         - raster interleave    size
  2840.  
  2841.      Writing a grafinfo file consists of these steps:
  2842.  
  2843.       1.  Create a directory in /usr/lib/grafinfo named after your
  2844.           graphics adapter vendor name.
  2845.  
  2846.       2.  Copy an existing grafinfo    file to    your new directory.
  2847.  
  2848.       3.  Edit the grafinfo    file using the information from    the graph-
  2849.           ics adapter documentation    and the    information in the
  2850.           ``Graphics Information File Structure'' section of this
  2851.           chapter.
  2852.  
  2853.       4.  Run mkdev    graphics so that the grafinfo file is recognized
  2854.           by the server.  For more information, refer to ``Video Con-
  2855.           figuration,'' in Chapter 2, ``Configuring    the Server.''
  2856.  
  2857.  
  2858.                     - 4     -
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.      0.4.1    Upgrading an Existing grafinfo File
  2865.  
  2866.      Upgrading a grafinfo file generally means adding new resolution
  2867.      information or    adding commands    to read    from and write to the I/O
  2868.      ports.     The final sections of this chapter discuss details of the
  2869.      grafinfo file format.
  2870.  
  2871.      The SetGraphics and SetText procedures    discussed later    in this
  2872.      chapter contain commands to read and write directly to    the I/O
  2873.      ports associated with your graphics adapter. Refer to the infor-
  2874.      mation    about the CLASS    command    for a list of port addresses for
  2875.      each graphics adapter class type (VGA,    CGA, EGA, and so on).
  2876.  
  2877.      For example, to modify    an VGA graphics    adapter    grafinfo file for
  2878.      a new resolution (assuming that the adapter has the capability    to
  2879.      switch    between    resolution settings):
  2880.  
  2881.       1.  Determine    whether    a new class needs to be    defined    by compar-
  2882.           ing the new mode's video memory base address and address
  2883.           window to    other mode descriptions    in the grafinfo    file.  If
  2884.           the new video memory requirements    match, you can copy the
  2885.           existing CLASS statement into the    new description.  Other-
  2886.           wise, you    must define a new class    by writing a new CLASS
  2887.           statement.
  2888.  
  2889.       2.  Determine    the required I/O ports for the new mode.  You may
  2890.           obtain this information from the hardware    documentation sup-
  2891.           plied with the adapter. If the new mode employs the same I/O
  2892.           ports as a mode already described    in the grafinfo    file, you
  2893.           can copy the existing PORT statements into the new descrip-
  2894.           tion.  PORT statements are included in grafinfo files pri-
  2895.           marily for reference purposes; the server    does not require
  2896.           them.  Be    sure to    use the    correct    I/O ports in your PRO-
  2897.           CEDURE definitions.
  2898.  
  2899.       3.  Add a new    MODE statement that defines a new mode name.
  2900.  
  2901.       4.  Create PROCEDURE statements for the new adapter mode in the
  2902.           grafinfo file.
  2903.  
  2904.       5.  Add or change the    sequence of out    commands in the    SetGraph-
  2905.           ics procedure to change the resolution of    the adapter.  Note
  2906.           that the server does not require a SetText procedure.
  2907.  
  2908.       6.  Run mkdev    graphics so that the adapter can be recognized by
  2909.           the server.
  2910.  
  2911.      0.5  Graphics Information File    Structure
  2912.  
  2913.      Grafinfo files    can contain more than one mode description for a
  2914.      particular board. Each    mode description consists of the following
  2915.      four sections:
  2916.  
  2917.         o header
  2918.  
  2919.           The grafinfo header defines the vendor, model, class, and
  2920.           resolution mode. It also defines the text    that appears while
  2921.           running mkdev graphics.  At server startup, the X    server
  2922.  
  2923.  
  2924.                     - 5     -
  2925.  
  2926.  
  2927.     X11R4 Server EFS Release and Installation Notes
  2928.  
  2929.           reads mode descriptions whose header information matches the
  2930.           mode descriptions    in /usr/lib/grafinfo/grafdev.
  2931.  
  2932.         o memory and I/O port definition
  2933.  
  2934.           The memory definition defines the    base address and size of
  2935.           the address window through which the X server accesses the
  2936.           graphics adapter's video memory. The I/O port definitions
  2937.           provide the  I/O port addresses through which the    server
  2938.           passes commands to the graphics adapter. Unlike the memory
  2939.           definition, the I/O port definitions are not used    by the X
  2940.           server; they are primarily included for reference.
  2941.  
  2942.         o parameter    definitions
  2943.  
  2944.           The DATA section of each grafinfo    mode description can
  2945.           define parameters    unique to that particular graphics adapter
  2946.           mode. As new graphics adapters are supported by new Xsco
  2947.           drivers, new parameters can be added to the DATA section.
  2948.  
  2949.         o procedure    definitions
  2950.  
  2951.           The procedure definitions    consist    of sequences of    read and
  2952.           write operations to the I/O ports.  In the majority of the
  2953.           grafinfo files supplied with this    EFS, two procedures are
  2954.           defined:    SetGraphics and    SetText.
  2955.  
  2956.     *********************************************************************
  2957.     NOTE
  2958.  
  2959.     To ensure compatibility in new grafinfo files, examine existing
  2960.     grafinfo files and follow the structure and    syntax carefully.
  2961.     *********************************************************************
  2962.  
  2963.  
  2964.      0.5.1    Comments
  2965.  
  2966.      Include comments in grafinfo files wherever they are needed.
  2967.      Following C language conventions, comments begin with /* and end
  2968.      with  */ symbols.  Comments may span several lines of text.
  2969.  
  2970.     *********************************************************************
  2971.     NOTE
  2972.  
  2973.     Comments should not    be nested.
  2974.     *********************************************************************
  2975.  
  2976.  
  2977.  
  2978.      0.6  Grafinfo Header
  2979.  
  2980.      Each mode that    is described in    a grafinfo file    starts with a
  2981.      header    that includes the following parameter definitions:
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.                     - 6     -
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2996.      VENDOR      graphics adapter vendor's name
  2997.      MODEL      graphics adapter model
  2998.      CLASS      display class    (such as VGA, EGA, and so on)
  2999.      MODE      display resolution
  3000.      MEMORY      base address and length
  3001.      PORT      I/O port addresses
  3002.  
  3003.      The following is an example of    a header:
  3004.  
  3005.      VENDOR    IBM        "IBM"
  3006.       MODEL     VGA         "VGA"
  3007.        CLASS  VGA          "VGA"
  3008.         MODE   320x200-256 "320x200    256-color"    /* VGA 320x200 256 color */
  3009.  
  3010.            MEMORY(0xA0000,0x10000);           /*  Base    Address, Length           */
  3011.            PORT(0x3C2,0x3CA,0x3CC,0x3DA);  /*  General/External registers  */
  3012.            PORT(0x3C0,0x3C1);           /*  Attribute               */
  3013.            PORT(0x3C4,0x3C5);           /*  Sequencer               */
  3014.            PORT(0x3C7,0x3C8,0x3C9);           /*  Color registers           */
  3015.            PORT(0x3CE,0x3CF);           /*  Graphics               */
  3016.            PORT(0x3D4,0x3D5);           /*  CRTC                   */
  3017.  
  3018.  
  3019.      The statements    following the header are executed only if the VEN-
  3020.      DOR, MODEL, CLASS, and    MODE statements    match the device name
  3021.      specified in /usr/lib/grafinfo/grafdev.  Note that the    names of
  3022.      the grafinfo file and the directory in    which it resides must also
  3023.      match the MODEL and VENDOR statements exactly,    or the X server
  3024.      rejects the entire grafinfo file.
  3025.  
  3026.      Details on grafinfo file header components follow.
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.      ____________________________________________________
  3052.  
  3053.  
  3054.  
  3055.  
  3056.                     - 7     -
  3057.  
  3058.  
  3059.     X11R4 Server EFS Release and Installation Notes
  3060.  
  3061.  
  3062.      Syntax:    VENDOR vendor-name   comment
  3063.  
  3064.      Description:    matches    vendor-name against the    vendor
  3065.             field of a complete mode description
  3066.             listed in /usr/lib/grafinfo/grafdev. The
  3067.             statements following this command exe-
  3068.             cute only if vendor-name matches the
  3069.             vendor field of    the device name.
  3070.  
  3071.             The vendor entry consists of three
  3072.             fields:
  3073.  
  3074.                o the reserved word,    VENDOR
  3075.  
  3076.                o the name of the graphics adapter
  3077.                  vendor in uppercase or lowercase
  3078.  
  3079.                o a quoted string of    up to 20 charac-
  3080.                  ters. The quoted string is    a com-
  3081.                  ment that is used by the mkdev
  3082.                  graphics installation script to
  3083.                  provide information about the
  3084.                  graphics adapter in prompt    choices.
  3085.  
  3086.      Example:    For example, a vendor name for a card
  3087.             made by    Paradise might be:
  3088.  
  3089.  
  3090.                  VENDOR PARADISE     "Paradise"
  3091.  
  3092.  
  3093.             The vendor name    is used    to locate the
  3094.             appropriate grafinfo file and matches
  3095.             the directory name.  In    this example,
  3096.             the file would be found    in the directory
  3097.             /usr/lib/grafinfo/paradise.
  3098.  
  3099.      ____________________________________________________
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.      ____________________________________________________
  3118.  
  3119.  
  3120.  
  3121.  
  3122.                     - 8     -
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.      Syntax:    MODEL adapter-model    comment
  3129.  
  3130.      Description:    matches    adapter-model name against the
  3131.             model field of a complete mode descrip-
  3132.             tion listed in
  3133.             /usr/lib/grafinfo/grafdev. adapter-model
  3134.             indicates one of the various models of a
  3135.             vendor's device.  The statements follow-
  3136.             ing this command execute only if
  3137.             adapter-model matches the adapter model
  3138.             field of the device name, and the vendor
  3139.             field of the device name matches the
  3140.             preceding VENDOR command.
  3141.  
  3142.             The model entry    consists of three
  3143.             fields:
  3144.  
  3145.                o the reserved word,    MODEL
  3146.  
  3147.                o the name of the graphics adapter
  3148.                  model in uppercase    or lowercase
  3149.  
  3150.                o a quoted string of    up to 20 charac-
  3151.                  ters in length. The leading space
  3152.                  before the    command    is required.
  3153.                  The quoted    string is a comment that
  3154.                  is    used by    the mkdev graphics ins-
  3155.                  tallation script to provide infor-
  3156.                  mation about the graphics adapter
  3157.                  in    prompt choices.
  3158.  
  3159.             The mkdev graphics script only displays
  3160.             the first MODEL    command    in a graphics
  3161.             information file.  Consequently,
  3162.             separate files should be used for
  3163.             separate models    if the information in
  3164.             this comment is    needed to distinguish
  3165.             one menu selection from    another.  The
  3166.             first level menu displays the comments
  3167.             from the first VENDOR and MODEL    commands
  3168.             in each    file, while the    second level
  3169.             menus display the comments from    the
  3170.             CLASS and MODE commands    preceding each
  3171.             set of procedures in the file selected
  3172.             from the first level menu.
  3173.  
  3174.      Example:
  3175.             A model    name for a VGA-Plus card can be
  3176.             specified as:
  3177.  
  3178.             MODEL VGAPLUS      "VGA Plus"
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.                     - 9     -
  3189.  
  3190.  
  3191.     X11R4 Server EFS Release and Installation Notes
  3192.  
  3193.             The model name is used to locate the
  3194.             grafinfo file and matches the filename.
  3195.             In this    example, the file would    be named
  3196.             vgaplus.xgi.
  3197.  
  3198.      ____________________________________________________
  3199.      ____________________________________________________
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.  
  3248.  
  3249.  
  3250.  
  3251.  
  3252.  
  3253.  
  3254.                    - 10     -
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.      Syntax:    CLASS class comment
  3261.  
  3262.      Description:    matches    class against the class    field of
  3263.             a complete mode    description listed in
  3264.             /usr/lib/grafinfo/grafdev. The state-
  3265.             ments following    this command execute
  3266.             only if    class matches the class    field of
  3267.             the device name, and the vendor    and
  3268.             model fields of    the device name    match
  3269.             the preceding VENDOR and MODEL commands.
  3270.  
  3271.            The class entry consists of three fields:
  3272.  
  3273.               o    the reserved word, CLASS
  3274.  
  3275.               o    the name of the    graphics adapter class in upper-
  3276.             case or    lowercase
  3277.  
  3278.               o    a quoted string    of up to 20 characters in length.
  3279.             Note that two leading spaces are required before
  3280.             the command.  The quoted string    is a comment that
  3281.             is used    by the mkdev graphics installation script
  3282.             to provide information about the graphics adapter
  3283.             in prompt choices.
  3284.  
  3285.      You can specify a new class name in the grafinfo file.    When new
  3286.      classes are specified,    a new entry is created in the class.h file
  3287.      (class.h is located in    the /etc/conf/pack.d/cn    directory for the
  3288.      console driver).
  3289.  
  3290.      For information on classes currently supported, refer to the
  3291.      grafinfo files    supplied with the Xsco server.    If you have a
  3292.      board that requires a memory base or amount of    memory not sup-
  3293.      ported    by one of these    classes, add a new class to the    grafinfo
  3294.      file.    When the mkdev graphics    utility    is executed, and a class
  3295.      is detected that is not currently in class.h, class.h is updated
  3296.      and the kernel    must be    relinked.
  3297.     ____________________________________________________
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.  
  3308.  
  3309.  
  3310.  
  3311.  
  3312.  
  3313.  
  3314.  
  3315.     ____________________________________________________
  3316.  
  3317.  
  3318.  
  3319.  
  3320.                    - 11     -
  3321.  
  3322.  
  3323.     X11R4 Server EFS Release and Installation Notes
  3324.  
  3325.  
  3326.     Syntax:       MODE    name comment
  3327.  
  3328.     Description:   matches name    against    the mode field of a
  3329.            complete mode description listed in
  3330.            /usr/lib/grafinfo/grafdev. The state-
  3331.            ments following this    command    execute
  3332.            only    if the mode name matches the mode
  3333.            field of the    device name, and the ven-
  3334.            dor,    model, and class fields    of the dev-
  3335.            ice name match the preceding    VENDOR,
  3336.            MODEL, and CLASS commands. The MODE
  3337.            entry consists of three fields:
  3338.  
  3339.               o    the reserved word, MODE
  3340.  
  3341.               o    the mode name, which can be used to
  3342.             indicate one of    the various resolu-
  3343.             tions, number of colors, and other
  3344.             display    characteristics    that a dev-
  3345.             ice can    support
  3346.  
  3347.               o    a quoted string    of up to 40 charac-
  3348.             ters.  The quoted string is a com-
  3349.             ment that is used by the mkdev
  3350.             graphics installation script to
  3351.             provide    information about how to
  3352.             set up the graphics adapter in
  3353.             prompt choices.
  3354.            Note    that three leading spaces are
  3355.            required before the command.    By conven-
  3356.            tion, the mode name uses the    following
  3357.            format:
  3358.  
  3359.            width x height [-colors] [-
  3360.            refresh_rate] [-other_characteristics]
  3361.  
  3362.            width and height are    the width and
  3363.            height of the display, in pixels. To
  3364.            avoid confusion, these values should
  3365.            match the values in the PIXWIDTH and
  3366.            PIXHEIGHT commands in the DATA section
  3367.            and the way the graphics adapter is set
  3368.            up in the SetGraphics procedure.
  3369.            refresh_rate    is the vertical    refresh
  3370.            rate, if more than one rate is sup-
  3371.            ported.  colors is the number of colors,
  3372.            if the display is not monochrome.
  3373.            other_characteristics is any    other
  3374.            feature that    distinguishes this mode
  3375.            from    another    mode supported by the
  3376.            display adapter, such as -I for an
  3377.            interlaced display.
  3378.  
  3379.  
  3380.  
  3381.            name    can also be the    keyword    ``DUMMY.''
  3382.            This    creates    a grafinfo mode    that users
  3383.            cannot select while running mkdev graph-
  3384.  
  3385.  
  3386.                    - 12     -
  3387.  
  3388.  
  3389.  
  3390.  
  3391.            ics.    This is    helpful    when you need to
  3392.            map in more than one    memory region.
  3393.  
  3394.  
  3395.  
  3396.  
  3397.     Example:       MODE      800x600-16  "800x600 16 color"
  3398.  
  3399.     ____________________________________________________
  3400.     ____________________________________________________
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.  
  3446.  
  3447.  
  3448.  
  3449.  
  3450.  
  3451.  
  3452.                    - 13     -
  3453.  
  3454.  
  3455.     X11R4 Server EFS Release and Installation Notes
  3456.  
  3457.  
  3458.     Syntax:       MEMORY(value[-value][,value]);
  3459.  
  3460.     Description:   declares physical memory locations that are
  3461.            accessed by the procedure definition    that follows
  3462.            this    command. The PORT and MEMORY commands define
  3463.            the device class.  Memory locations must be on 4
  3464.            kilobyte boundaries.     Currently, each grafinfo mode
  3465.            is limited to one memory definition.
  3466.  
  3467.     Example:       MEMORY(0xA0000,0x10000); /* Base Address, Length */
  3468.  
  3469.     ____________________________________________________
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509.  
  3510.  
  3511.  
  3512.  
  3513.  
  3514.  
  3515.  
  3516.  
  3517.  
  3518.                    - 14     -
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.     Syntax:       PORT(value[-value][,value]);
  3525.  
  3526.     Description:   declares the    I/O ports that are accessed by
  3527.            the procedure definition that follows this
  3528.            command.  A list of values or value ranges can
  3529.            be specified.  The PORT and MEMORY commands
  3530.            define the device class.
  3531.  
  3532.     Example:       PORT(0x3C7,0x3C8,0x3C9); /* Color registers */
  3533.  
  3534.     0.7     Grafinfo Parameters
  3535.  
  3536.     Grafinfo parameters    are defined, one per line, within DATA statements.
  3537.     Each parameter definition has the following    syntax:
  3538.  
  3539.      parameter_name                              =    value;
  3540.  
  3541.     parameter_name can be any string, provided it does not conflict with
  3542.     other parameters or    keywords.  In the grafinfo files supplied in this
  3543.     EFS, value is an integer or    a quoted string.  There    are no other res-
  3544.     trictions on parameter definitions.     If you    include    parameter defini-
  3545.     tions that are not required    by the graphics    adapter    driver,    the Xsco
  3546.     server ignores them.  Table    5.1 contains a list of parameters that are
  3547.     used by the    grafinfo files supplied    in this    EFS.
  3548.  
  3549.             TABLE 1.  Grafinfo Parameters
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.  
  3569.  
  3570.  
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.  
  3584.                    - 15     -
  3585.  
  3586.  
  3587.     X11R4 Server EFS Release and Installation Notes
  3588.  
  3589.  
  3590.          ____________________________________________________
  3591.          |Parameter      | Purpose                 |
  3592.          |____________|______________________________________|
  3593.          |DEPTH      | number of planes             |
  3594.          |DEVTYPE      | hardware type             |
  3595.          |DEVTECH      | video memory organization         |
  3596.          |PIXBYTES      | bytes per raster line         |
  3597.          |PIXWIDTH      | horizontal pixel count         |
  3598.          |PIXHEIGHT      | vertical pixel count         |
  3599.          |PIXBITS      | adjacent color bits    per pixel     |
  3600.          |PIXPLANES      | color planes count             |
  3601.          |BASEADDRESS | base physical memory address     |
  3602.          |INTERLEAVE  | raster-interleave factor         |
  3603.          |INTERSIZE      | raster-interleave size         |
  3604.          |MAPTYPE      | select bank    manager             |
  3605.          |VISUAL      | selects graphics adapter visual type |
  3606.          |XDRIVER      | selects graphics adapter driver     |
  3607.          |____________|______________________________________|
  3608.  
  3609.     The    following commands are not supported by    the X server but appear    in
  3610.     grafinfo files written for the Xsight server:
  3611.  
  3612.        o DEVATTR
  3613.  
  3614.        o MAPFLAGS
  3615.  
  3616.        o MAPWINSCANS
  3617.  
  3618.        o WINBANK
  3619.  
  3620.        o WINOFFSET
  3621.  
  3622.        o WINSCANS
  3623.  
  3624.        o WINTYPE
  3625.  
  3626.      It is recommended that    grafinfo statements including these com-
  3627.      mands be commented-out.
  3628.  
  3629.      0.7.1    Parameter Descriptions
  3630.  
  3631.      The grafinfo parameters are listed in alphabetical order in this
  3632.      section and can be coded in either upper- or lowercase. Note that
  3633.      command syntax    descriptions indicate if a terminating semicolon
  3634.      is required.
  3635.  
  3636.      ____________________________________________________
  3637.  
  3638.  
  3639.  
  3640.  
  3641.  
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647.  
  3648.  
  3649.  
  3650.                    - 16     -
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.      Syntax:    BASEADDRESS = address;
  3657.  
  3658.      Description:    sets the base physical memory address
  3659.             for the    graphics display screen
  3660.  
  3661.      Example:    BASEADDRESS = 0xA0000;
  3662.  
  3663.      ____________________________________________________
  3664.  
  3665.  
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.                    - 17     -
  3717.  
  3718.  
  3719.     X11R4 Server EFS Release and Installation Notes
  3720.  
  3721.  
  3722.      Syntax:    DEVTECH    = value;
  3723.  
  3724.      Description:    indicates the video memory structure for a dev-
  3725.             ice, where value is any    of the following:
  3726.             0x0000 = Monochrome, flat, linear
  3727.             0x0001 = Monochrome, flat, interleaved
  3728.             0x0002 = Monochrome, bank-switched, linear
  3729.             0x0003 = Monochrome, bank-switched, interleaved
  3730.             0x0004 = Multibit, flat, linear
  3731.             0x0005 = Multibit, flat, interleaved
  3732.             0x0006 = Multibit, bank-switched, linear
  3733.             0x0007 = Multibit, bank-switched, interleaved
  3734.             0x0008 = Multiplane, flat, linear
  3735.             0x0009 = Multiplane, flat, interleaved
  3736.             0x000A = Multiplane, bank-switched, linear
  3737.             0x000B = Multiplane, bank-switched, interleaved
  3738.             0x000D = VGA, flat, linear
  3739.             0x000E = VGA, bank-switched, linear
  3740.             0x000F = VGA, segmented, linear
  3741.             0x0010 = TMS 34010, rowBytes, powers of    2
  3742.             0x0011 = TMS 34010, rowBytes, variable
  3743.             0x0014 = IBM 8514
  3744.             0x0018 = 8 bit 256 color linear
  3745.             0x0019 = 8 bit 256 color interlaced
  3746.             0x001A = 8 bit 256 color VGA
  3747.  
  3748.             If the XDRIVER parameter is ``mw,'' DEVTECH
  3749.             cannot be 0x0010, 0x0011, or 0x0014.
  3750.  
  3751.      Example:    DEVTECH=0x0D;/*    VGA */
  3752.  
  3753.      Note:        If you have grafinfo files from    prior versions
  3754.             of ODT-VIEW, ensure that DEVTECH has a correct
  3755.             value.    If the value is    not correct, the server
  3756.             does not initialize.
  3757.  
  3758.      ____________________________________________________
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.  
  3778.  
  3779.  
  3780.  
  3781.  
  3782.                    - 18     -
  3783.  
  3784.  
  3785.  
  3786.  
  3787.  
  3788.      Syntax:    DEVTYPE    = value;
  3789.  
  3790.      Description:    For LCD, plasma, and monochrome    moni-
  3791.             tors, use, DEVTYPE = 0.     For IBM EGA/VGA
  3792.             displays, use DEVTYPE =    0x01.  For EVC
  3793.             adapters, use DEVTYPE =    0x02.
  3794.  
  3795.  
  3796.      ____________________________________________________
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.  
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.  
  3833.  
  3834.  
  3835.  
  3836.  
  3837.  
  3838.  
  3839.  
  3840.  
  3841.  
  3842.  
  3843.  
  3844.  
  3845.  
  3846.  
  3847.  
  3848.                    - 19     -
  3849.  
  3850.  
  3851.     X11R4 Server EFS Release and Installation Notes
  3852.  
  3853.  
  3854.      Syntax:    INTERLEAVE = value;
  3855.  
  3856.      Description:    sets the display adapter raster-
  3857.             interleave factor.  INTERLEAVE works in
  3858.             conjunction with INTERSIZE.  The default
  3859.             interleave is ``1.''
  3860.  
  3861.      Example:    INTERLEAVE  = 1;
  3862.  
  3863.      ____________________________________________________
  3864.  
  3865.  
  3866.  
  3867.  
  3868.  
  3869.  
  3870.  
  3871.  
  3872.  
  3873.  
  3874.  
  3875.  
  3876.  
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.  
  3891.  
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.  
  3899.  
  3900.  
  3901.  
  3902.  
  3903.  
  3904.  
  3905.  
  3906.  
  3907.  
  3908.  
  3909.  
  3910.  
  3911.  
  3912.  
  3913.  
  3914.                    - 20     -
  3915.  
  3916.  
  3917.  
  3918.  
  3919.      ____________________________________________________
  3920.  
  3921.  
  3922.  
  3923.  
  3924.  
  3925.  
  3926.  
  3927.  
  3928.  
  3929.  
  3930.  
  3931.  
  3932.  
  3933.  
  3934.  
  3935.  
  3936.  
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.  
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.  
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.  
  3969.  
  3970.  
  3971.  
  3972.  
  3973.  
  3974.  
  3975.  
  3976.  
  3977.  
  3978.  
  3979.  
  3980.                    - 21     -
  3981.  
  3982.  
  3983.     X11R4 Server EFS Release and Installation Notes
  3984.  
  3985.  
  3986.      Syntax:    INTERSIZE = value;
  3987.  
  3988.      Description:    sets the display adapter raster-
  3989.             interleave size.  INTERSIZE is the
  3990.             number of bytes    from the start of one
  3991.             row to the start of the    next, in screen
  3992.             order. The default INTERSIZE is    the
  3993.             current    value of PIXBYTES.
  3994.  
  3995.      ____________________________________________________
  3996.  
  3997.  
  3998.  
  3999.  
  4000.  
  4001.  
  4002.  
  4003.  
  4004.  
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.  
  4033.  
  4034.  
  4035.  
  4036.  
  4037.  
  4038.  
  4039.  
  4040.  
  4041.  
  4042.  
  4043.  
  4044.  
  4045.  
  4046.                    - 22     -
  4047.  
  4048.  
  4049.  
  4050.  
  4051.  
  4052.         Thus, if a device has a 12x9, 1-bit-
  4053.         per-pixel display, video memory is
  4054.         arranged as    follows:
  4055.  
  4056.  
  4057.               Screen Order                  Memory Order
  4058.           Row  Address  Pixels             Address  Row   Pixels
  4059.            1    A0000   * *    * * * *    * *|* *    * *   A0000    1    ******** ****....
  4060.            2    A0008   * *    * * * *    * *|* *    * *   A0002    4    ******** ****....
  4061.            3    A0010   * *    * * * *    * *|* *    * *   A0004    7    ******** ****....
  4062.            4    A0002   * *    * * * *    * *|* *    * *   A0006   pad   ........ ........
  4063.            5    A000A   * *    * * * *    * *|* *    * *   A0008    2    ******** ****....
  4064.            6    A0012   * *    * * * *    * *|* *    * *   A000A    5    ******** ****....
  4065.            7    A0004   * *    * * * *    * *|* *    * *   A000C    8    ******** ****....
  4066.            8    A000C   * *    * * * *    * *|* *    * *   A000E   pad   ........ ........
  4067.            9    A0014   * *    * * * *    * *|* *    * *   A0010    3    ******** ****....
  4068.                               A0012    6    ******** ****....
  4069.                               A0014    9    ******** ****....
  4070.                               A0016   pad   ........ ........
  4071.  
  4072.           Set:
  4073.               PIXBYTES      = 2;
  4074.               PIXWIDTH      = 12;
  4075.               PIXHEIGHT      = 9;
  4076.               PIXBITS      = 1;
  4077.               PIXPLANES      = 1;
  4078.               BASEADDRESS = 0XA0000;
  4079.               INTERLEAVE  = 3;
  4080.               INTERSIZE      = 0x8;
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.  
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099.  
  4100.  
  4101.  
  4102.  
  4103.  
  4104.  
  4105.  
  4106.  
  4107.  
  4108.  
  4109.  
  4110.  
  4111.  
  4112.                    - 23     -
  4113.  
  4114.  
  4115.     X11R4 Server EFS Release and Installation Notes
  4116.  
  4117.  
  4118.           On both diagrams:             *    represents a displayable bit.
  4119.           On the screen order diagram:   |    represents the byte boundary.
  4120.           On the memory order diagram:   .    represents an "off screen" bit.
  4121.  
  4122.           ____________________________________________________
  4123.           ____________________________________________________
  4124.  
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.  
  4155.  
  4156.  
  4157.  
  4158.  
  4159.  
  4160.  
  4161.  
  4162.  
  4163.  
  4164.  
  4165.  
  4166.  
  4167.  
  4168.  
  4169.  
  4170.  
  4171.  
  4172.  
  4173.  
  4174.  
  4175.  
  4176.  
  4177.  
  4178.                    - 24     -
  4179.  
  4180.  
  4181.  
  4182.  
  4183.  
  4184.           Syntax:         MAPTYPE = entry;
  4185.  
  4186.           Description:   selects server bank-switching
  4187.                  mechanism.     The following are
  4188.                  legal values for MAPTYPE:
  4189.  
  4190.  
  4191.  
  4192.          o "Cornerstone"
  4193.  
  4194.  
  4195.          o "Cornerstone    MC"
  4196.  
  4197.  
  4198.          o "EGA"
  4199.  
  4200.  
  4201.          o "ATIWonder+800x600x256"
  4202.  
  4203.  
  4204.          o "ATIWonder+1024x768x16"
  4205.  
  4206.  
  4207.          o "ATIWonder+1024x768x256"
  4208.  
  4209.  
  4210.          o "ET4000M800x600x256"
  4211.  
  4212.  
  4213.          o "ET4000M1024x768x16"
  4214.  
  4215.  
  4216.          o "ET4000M1024x768x256"
  4217.  
  4218.  
  4219.          o "TRIDENT8900B128K"
  4220.  
  4221.  
  4222.          o "TRIDENT8900C64K"
  4223.  
  4224.  
  4225.          o "TSENG3000_64K"
  4226.  
  4227.  
  4228.          o "TSENG3000_128K"
  4229.  
  4230.  
  4231.          o "TSENG4000_2_64K"
  4232.  
  4233.  
  4234.          o "PARADISE_1_64K"
  4235.  
  4236.  
  4237.          o "PARADISE_1_128K"
  4238.  
  4239.  
  4240.          o "PARADISE_2_32K"
  4241.  
  4242.  
  4243.  
  4244.                    - 25     -
  4245.  
  4246.  
  4247.     X11R4 Server EFS Release and Installation Notes
  4248.  
  4249.  
  4250.          o "PARADISE_3_64K"
  4251.  
  4252.  
  4253.          o "CHIPS451_64K"
  4254.  
  4255.  
  4256.          o "CHIPS451_128K"
  4257.  
  4258.  
  4259.          o "CHIPS452_64K"
  4260.  
  4261.  
  4262.          o "CHIPS452_128K"
  4263.  
  4264.  
  4265.          o "CHIPS453_32K"
  4266.  
  4267.  
  4268.          o "CHIPS453_64K"
  4269.  
  4270.  
  4271.          o "ATI1828_64K"
  4272.  
  4273.  
  4274.          o "GENOA_64K"
  4275.  
  4276.  
  4277.          o "GENOA_128K"
  4278.  
  4279.  
  4280.          o "GENOA_2_128K"
  4281.  
  4282.  
  4283.          o "VIDEO7V3_64K"
  4284.  
  4285.  
  4286.          o "VIDEO7V4_64K"
  4287.  
  4288.  
  4289.          o COMPAQ_2_64K"
  4290.  
  4291.  
  4292.          o "NoopMngr"
  4293.      ____________________________________________________
  4294.  
  4295.  
  4296.  
  4297.  
  4298.  
  4299.  
  4300.  
  4301.  
  4302.  
  4303.  
  4304.  
  4305.  
  4306.  
  4307.  
  4308.  
  4309.  
  4310.                    - 26     -
  4311.  
  4312.  
  4313.  
  4314.  
  4315.  
  4316.      Syntax:    PIXBITS    = number;
  4317.  
  4318.      Description:    sets the number    of adjacent color bits
  4319.             per pixel. Legal values    are 1 and 8.
  4320.  
  4321.      Example:    PIXBITS    = 1;
  4322.  
  4323.      ____________________________________________________
  4324.  
  4325.  
  4326.  
  4327.  
  4328.  
  4329.  
  4330.  
  4331.  
  4332.  
  4333.  
  4334.  
  4335.  
  4336.  
  4337.  
  4338.  
  4339.  
  4340.  
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.  
  4350.  
  4351.  
  4352.  
  4353.  
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.  
  4361.  
  4362.  
  4363.  
  4364.  
  4365.  
  4366.  
  4367.  
  4368.  
  4369.  
  4370.  
  4371.  
  4372.  
  4373.  
  4374.  
  4375.  
  4376.                    - 27     -
  4377.  
  4378.  
  4379.     X11R4 Server EFS Release and Installation Notes
  4380.  
  4381.  
  4382.      Syntax:    PIXBYTES = value;
  4383.  
  4384.      Description:    sets the number    of bytes-per-raster-
  4385.             line.  PIXBYTES    should be calculated as
  4386.             (PIXWIDTH+7)/8.
  4387.  
  4388.      Example:    PIXBYTES = 80;
  4389.  
  4390.      ____________________________________________________
  4391.      ____________________________________________________
  4392.  
  4393.  
  4394.  
  4395.  
  4396.  
  4397.  
  4398.  
  4399.  
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.  
  4420.  
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.  
  4427.  
  4428.  
  4429.  
  4430.  
  4431.  
  4432.  
  4433.  
  4434.  
  4435.  
  4436.  
  4437.  
  4438.  
  4439.  
  4440.  
  4441.  
  4442.                    - 28     -
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.      Syntax:    PIXHEIGHT = value;
  4449.  
  4450.      Description:    sets the number    of pixels vertically.  This value
  4451.             and PIXWIDTH must match    the resolution set up in
  4452.             the SetGraphics    procedure and should match the
  4453.             values encoded in the MODE command.
  4454.  
  4455.      Example:    MODE   640x480-16  "640x480 16-color"
  4456.             ...
  4457.             PIXWIDTH    = 640;
  4458.             PIXHEIGHT   = 480;
  4459.             ...
  4460.             out(0x3C2,0xE3);  /*Put    in 640x480 16 color mode*/
  4461.  
  4462.      ____________________________________________________
  4463.  
  4464.  
  4465.  
  4466.  
  4467.  
  4468.  
  4469.  
  4470.  
  4471.  
  4472.  
  4473.  
  4474.  
  4475.  
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.  
  4485.  
  4486.  
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492.  
  4493.  
  4494.  
  4495.  
  4496.  
  4497.  
  4498.  
  4499.  
  4500.  
  4501.  
  4502.  
  4503.  
  4504.  
  4505.  
  4506.  
  4507.  
  4508.                    - 29     -
  4509.  
  4510.  
  4511.     X11R4 Server EFS Release and Installation Notes
  4512.  
  4513.  
  4514.      Syntax:    PIXPLANES = value;
  4515.  
  4516.      Description:    sets the number    of color planes
  4517.  
  4518.      Example:    PIXPLANES   = 4;
  4519.  
  4520.      ____________________________________________________
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.  
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.  
  4559.  
  4560.  
  4561.  
  4562.  
  4563.  
  4564.  
  4565.  
  4566.  
  4567.  
  4568.  
  4569.  
  4570.  
  4571.  
  4572.  
  4573.  
  4574.                    - 30     -
  4575.  
  4576.  
  4577.  
  4578.  
  4579.  
  4580.      Syntax:    PIXWIDTH = value;
  4581.  
  4582.      Description:    sets the number    of pixels horizontally.     This
  4583.             value and PIXHEIGHT must match the resolution set
  4584.             up in the SetGraphics procedure    and should match
  4585.             the values encoded in the MODE command.
  4586.  
  4587.      Example:    MODE   640x480-16  "640x480 16-color"
  4588.             ...
  4589.             PIXWIDTH    = 640;
  4590.             PIXHEIGHT   = 480;
  4591.             ...
  4592.             out(0x3C2,0xE3);  /*Put    in 640x480 16 color mode*/
  4593.  
  4594.      ____________________________________________________
  4595.      ____________________________________________________
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.  
  4603.  
  4604.  
  4605.  
  4606.  
  4607.  
  4608.  
  4609.  
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.  
  4628.  
  4629.  
  4630.  
  4631.  
  4632.  
  4633.  
  4634.  
  4635.  
  4636.  
  4637.  
  4638.  
  4639.  
  4640.                    - 31     -
  4641.  
  4642.  
  4643.     X11R4 Server EFS Release and Installation Notes
  4644.  
  4645.  
  4646.      Syntax:    VISUAL = value;
  4647.  
  4648.      Description:    specifies the visual type of the graph-
  4649.             ics adapter.  Legal values are ``Pseu-
  4650.             doColor'' and ``StaticGrey.''
  4651.  
  4652.      Example:      VISUAL      =    "PseudoColor";
  4653.  
  4654.      ____________________________________________________
  4655.  
  4656.  
  4657.  
  4658.  
  4659.  
  4660.  
  4661.  
  4662.  
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.  
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.  
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.  
  4693.  
  4694.  
  4695.  
  4696.  
  4697.  
  4698.  
  4699.  
  4700.  
  4701.  
  4702.  
  4703.  
  4704.  
  4705.  
  4706.                    - 32     -
  4707.  
  4708.  
  4709.  
  4710.  
  4711.  
  4712.      Syntax:    XDRIVER    = value;
  4713.  
  4714.      Description:    specifies the graphics adapter driver
  4715.             that is    loaded when the    Xsco server
  4716.             starts.     The following graphics    adapter
  4717.             drivers    are included with this EFS:
  4718.  
  4719.             mw      driver for VGA graphics
  4720.                   adapters
  4721.  
  4722.             dfb      driver for ``dumb frame
  4723.                   buffer'' graphics adapters
  4724.  
  4725.             eff      driver for 8514-based    graphics
  4726.                   adapters
  4727.  
  4728.             xga      driver for IBM XGA graphics
  4729.                   adapter
  4730.  
  4731.      ____________________________________________________
  4732.  
  4733.  
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759.  
  4760.  
  4761.  
  4762.  
  4763.  
  4764.  
  4765.  
  4766.  
  4767.  
  4768.  
  4769.  
  4770.  
  4771.  
  4772.                    - 33     -
  4773.  
  4774.  
  4775.     X11R4 Server EFS Release and Installation Notes
  4776.  
  4777.  
  4778.      0.8  Grafinfo Procedures
  4779.  
  4780.      A PROCEDURE statement indicates the start of a    device procedure
  4781.      definition. Device procedures define parameters or perform
  4782.      hardware-specific functions, such as physically switching a
  4783.      display adapter to graphics mode.  Device procedures are inter-
  4784.      preted    at runtime and allow portions of the X server to be
  4785.      defined independently from the    graphics adapter driver.  Grafinfo
  4786.      files include device procedure    definitions according to the
  4787.      requirements of the graphics adapter drivers they support.  The
  4788.      graphics adapter drivers included in this EFS require only the
  4789.      following two procedures:
  4790.  
  4791.         o SetGraphics switches the device into graphics mode.
  4792.  
  4793.         o SetText switches the device into text mode.
  4794.  
  4795.      For examples, refer to    ``Sample Grafinfo File,'' at the end of
  4796.      this chapter.    A device procedure is defined by a series of com-
  4797.      mands and variables that are enclosed by curly    braces ({}) fol-
  4798.      lowing    the PROCEDURE entry. A command can appear anywhere on a
  4799.      line in either    uppercase or lowercase.     A command may require
  4800.      variables, which appear after the command.  Commands and vari-
  4801.      ables must be separated by semicolons.
  4802.  
  4803.      Sixty-four variables, or registers, named r0 through r63, are
  4804.      available in a    PROCEDURE for storing temporary    values.     Each
  4805.      variable can hold a 16-bit integer.  When used    with the bout com-
  4806.      mand, values are always sent from R0 first.  Therefore, when
  4807.      selecting variables for purposes other    than writing data to the
  4808.      I/O ports, use    registers with numbers higher than the number of
  4809.      data values that you plan to output.
  4810.  
  4811.      Numeric values    can be specified in decimal or hexadecimal.  Hexa-
  4812.      decimal values    follow C language conventions and must be preceded
  4813.      by 0x (for example, 0x10, 0X10, 0xAFF2).
  4814.  
  4815.      0.9  Grafinfo Commands
  4816.  
  4817.      Table 5.2 contains a list of the commands that    are used in the
  4818.      SetGraphics and SetText procedures.  Note that    all procedure and
  4819.      command names are case-sensitive.
  4820.  
  4821.  
  4822.  
  4823.  
  4824.  
  4825.  
  4826.  
  4827.  
  4828.  
  4829.  
  4830.  
  4831.  
  4832.  
  4833.              TABLE 2.  Grafinfo Commands
  4834.  
  4835.  
  4836.  
  4837.  
  4838.                    - 34     -
  4839.  
  4840.  
  4841.  
  4842.  
  4843.  
  4844.                _____________________________________
  4845.                |Commands | Purpose            |
  4846.                |_________|__________________________|
  4847.                |and     | logical AND            |
  4848.                |bout     | write a byte    string        |
  4849.                |in     | read    a byte            |
  4850.                |not     | logical NOT            |
  4851.                |or     | logical OR            |
  4852.                |out     | write a byte            |
  4853.                |outw     | write a double-byte word |
  4854.                |set     | set a variable        |
  4855.                |shl     | logical shift left        |
  4856.                |shr     | logical shift right        |
  4857.                |wait     | delay processing        |
  4858.                |xor     | exclusive OR            |
  4859.                |_________|__________________________|
  4860.  
  4861.  
  4862.  
  4863.      0.9.1    Command    Descriptions
  4864.  
  4865.      The grafinfo commands are listed in alphabetical order    in this
  4866.      section and can be coded in either upper- or lowercase. Note that
  4867.      command syntax    descriptions indicate if a terminating semicolon
  4868.      is required.
  4869.  
  4870.      ____________________________________________________
  4871.  
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.  
  4882.  
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888.  
  4889.  
  4890.  
  4891.  
  4892.  
  4893.  
  4894.  
  4895.  
  4896.  
  4897.  
  4898.  
  4899.  
  4900.  
  4901.  
  4902.  
  4903.  
  4904.                    - 35     -
  4905.  
  4906.  
  4907.     X11R4 Server EFS Release and Installation Notes
  4908.  
  4909.  
  4910.      Syntax:    and(variable, value);
  4911.  
  4912.      Description:    performs a bitwise AND on variable using the specified
  4913.             value
  4914.  
  4915.      Example:    and(R0,    0x3f);     /* clear bits 6&7 - hi    res and    blank */
  4916.  
  4917.      ____________________________________________________
  4918.  
  4919.      ____________________________________________________
  4920.  
  4921.  
  4922.  
  4923.  
  4924.  
  4925.  
  4926.  
  4927.  
  4928.  
  4929.  
  4930.  
  4931.  
  4932.  
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.  
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.  
  4955.  
  4956.  
  4957.  
  4958.  
  4959.  
  4960.  
  4961.  
  4962.  
  4963.  
  4964.  
  4965.  
  4966.  
  4967.  
  4968.  
  4969.  
  4970.                    - 36     -
  4971.  
  4972.  
  4973.  
  4974.  
  4975.  
  4976.      Syntax:    bout(count, indexport, dataport);
  4977.  
  4978.      Description:    outputs    a block    of values to an    indexed    I/O port.  The
  4979.             first count variables starting from R0 are output by
  4980.             first sending an index to indexport and    then sending
  4981.             the variables to dataport.  The    bout command is    analo-
  4982.             gous to    the following C    code:
  4983.             for (index = 0;    index <    count; index++)
  4984.             {
  4985.                 out(indexport, index);
  4986.                 out(dataport, index);
  4987.             }
  4988.      Example:    The bout command is used with one or more assignment
  4989.             commands such as shown in the following    example:
  4990.             r0 = 0x1; r1= 0x01; r2 = 0x0F;    /* Assign values */
  4991.             bout(3,    0x3C4, 0x3C5);         /*    Output data to ports */
  4992.  
  4993.      ____________________________________________________
  4994.  
  4995.  
  4996.  
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.  
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.  
  5011.  
  5012.  
  5013.  
  5014.  
  5015.  
  5016.  
  5017.  
  5018.  
  5019.  
  5020.  
  5021.  
  5022.  
  5023.  
  5024.  
  5025.  
  5026.  
  5027.  
  5028.  
  5029.  
  5030.  
  5031.  
  5032.  
  5033.  
  5034.  
  5035.  
  5036.                    - 37     -
  5037.  
  5038.  
  5039.     X11R4 Server EFS Release and Installation Notes
  5040.  
  5041.  
  5042.      Syntax:    in(variable, port);
  5043.  
  5044.      Description:    reads an I/O port, port, and stores its
  5045.             value in variable
  5046.      Example:    in(r63,    0x1CF);
  5047.  
  5048.      ____________________________________________________
  5049.  
  5050.  
  5051.  
  5052.  
  5053.  
  5054.  
  5055.  
  5056.  
  5057.  
  5058.  
  5059.  
  5060.  
  5061.  
  5062.  
  5063.  
  5064.  
  5065.  
  5066.  
  5067.  
  5068.  
  5069.  
  5070.  
  5071.  
  5072.  
  5073.  
  5074.  
  5075.  
  5076.  
  5077.  
  5078.  
  5079.  
  5080.  
  5081.  
  5082.  
  5083.  
  5084.  
  5085.  
  5086.  
  5087.  
  5088.  
  5089.  
  5090.  
  5091.  
  5092.  
  5093.  
  5094.  
  5095.  
  5096.  
  5097.  
  5098.  
  5099.  
  5100.  
  5101.  
  5102.                    - 38     -
  5103.  
  5104.  
  5105.  
  5106.  
  5107.  
  5108.      Syntax:    not(variable);
  5109.  
  5110.      Description:    performs a bitwise NOT on variable
  5111.  
  5112.      ____________________________________________________
  5113.  
  5114.  
  5115.  
  5116.  
  5117.  
  5118.  
  5119.  
  5120.  
  5121.  
  5122.  
  5123.  
  5124.  
  5125.  
  5126.  
  5127.  
  5128.  
  5129.  
  5130.  
  5131.  
  5132.  
  5133.  
  5134.  
  5135.  
  5136.  
  5137.  
  5138.  
  5139.  
  5140.  
  5141.  
  5142.  
  5143.  
  5144.  
  5145.  
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.  
  5157.  
  5158.  
  5159.  
  5160.  
  5161.  
  5162.  
  5163.  
  5164.  
  5165.  
  5166.  
  5167.  
  5168.                    - 39     -
  5169.  
  5170.  
  5171.     X11R4 Server EFS Release and Installation Notes
  5172.  
  5173.  
  5174.      Syntax:    or(variable, value);
  5175.  
  5176.      Description:    performs a bitwise OR on a variable
  5177.             using the specified value
  5178.      Example:    /* set state on    extended registers */
  5179.             out(0x1CE, 0xB3); in(r63, 0x1CF);
  5180.             or(r63,    0x10);
  5181.             out(0x1CE, 0xB3); out(0x1CF, r63);
  5182.  
  5183.      ____________________________________________________
  5184.      ____________________________________________________
  5185.  
  5186.  
  5187.  
  5188.  
  5189.  
  5190.  
  5191.  
  5192.  
  5193.  
  5194.  
  5195.  
  5196.  
  5197.  
  5198.  
  5199.  
  5200.  
  5201.  
  5202.  
  5203.  
  5204.  
  5205.  
  5206.  
  5207.  
  5208.  
  5209.  
  5210.  
  5211.  
  5212.  
  5213.  
  5214.  
  5215.  
  5216.  
  5217.  
  5218.  
  5219.  
  5220.  
  5221.  
  5222.  
  5223.  
  5224.  
  5225.  
  5226.  
  5227.  
  5228.  
  5229.  
  5230.  
  5231.  
  5232.  
  5233.  
  5234.                    - 40     -
  5235.  
  5236.  
  5237.  
  5238.  
  5239.  
  5240.      Syntax:    out(port, value);
  5241.             outw(port, value);
  5242.  
  5243.      Description:    outputs    a value    to an I/O port.    outw
  5244.             outputs    a double-byte word.
  5245.  
  5246.      Example:    out(0x3C0,0);  /* disable palette */
  5247.  
  5248.      ____________________________________________________
  5249.  
  5250.  
  5251.  
  5252.  
  5253.  
  5254.  
  5255.  
  5256.  
  5257.  
  5258.  
  5259.  
  5260.  
  5261.  
  5262.  
  5263.  
  5264.  
  5265.  
  5266.  
  5267.  
  5268.  
  5269.  
  5270.  
  5271.  
  5272.  
  5273.  
  5274.  
  5275.  
  5276.  
  5277.  
  5278.  
  5279.  
  5280.  
  5281.  
  5282.  
  5283.  
  5284.  
  5285.  
  5286.  
  5287.  
  5288.  
  5289.  
  5290.  
  5291.  
  5292.  
  5293.  
  5294.  
  5295.  
  5296.  
  5297.  
  5298.  
  5299.  
  5300.                    - 41     -
  5301.  
  5302.  
  5303.     X11R4 Server EFS Release and Installation Notes
  5304.  
  5305.  
  5306.      Syntax:    set(variable1, variable2);
  5307.  
  5308.      Description:    sets variable1 equal to    variable2
  5309.  
  5310.      ____________________________________________________
  5311.  
  5312.  
  5313.  
  5314.  
  5315.  
  5316.  
  5317.  
  5318.  
  5319.  
  5320.  
  5321.  
  5322.  
  5323.  
  5324.  
  5325.  
  5326.  
  5327.  
  5328.  
  5329.  
  5330.  
  5331.  
  5332.  
  5333.  
  5334.  
  5335.  
  5336.  
  5337.  
  5338.  
  5339.  
  5340.  
  5341.  
  5342.  
  5343.  
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353.  
  5354.  
  5355.  
  5356.  
  5357.  
  5358.  
  5359.  
  5360.  
  5361.  
  5362.  
  5363.  
  5364.  
  5365.  
  5366.                    - 42     -
  5367.  
  5368.  
  5369.  
  5370.  
  5371.  
  5372.      Syntax:    shl(variable, value);
  5373.  
  5374.      Description:    performs a logical shift left of value
  5375.             bits on    variable
  5376.  
  5377.      ____________________________________________________
  5378.  
  5379.  
  5380.  
  5381.  
  5382.  
  5383.  
  5384.  
  5385.  
  5386.  
  5387.  
  5388.  
  5389.  
  5390.  
  5391.  
  5392.  
  5393.  
  5394.  
  5395.  
  5396.  
  5397.  
  5398.  
  5399.  
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.  
  5420.  
  5421.  
  5422.  
  5423.  
  5424.  
  5425.  
  5426.  
  5427.  
  5428.  
  5429.  
  5430.  
  5431.  
  5432.                    - 43     -
  5433.  
  5434.  
  5435.     X11R4 Server EFS Release and Installation Notes
  5436.  
  5437.  
  5438.      Syntax:    shr(variable, value);
  5439.  
  5440.      Description:    performs a logical shift right of value
  5441.             bits on    variable
  5442.  
  5443.      ____________________________________________________
  5444.  
  5445.  
  5446.  
  5447.  
  5448.  
  5449.  
  5450.  
  5451.  
  5452.  
  5453.  
  5454.  
  5455.  
  5456.  
  5457.  
  5458.  
  5459.  
  5460.  
  5461.  
  5462.  
  5463.  
  5464.  
  5465.  
  5466.  
  5467.  
  5468.  
  5469.  
  5470.  
  5471.  
  5472.  
  5473.  
  5474.  
  5475.  
  5476.  
  5477.  
  5478.  
  5479.  
  5480.  
  5481.  
  5482.  
  5483.  
  5484.  
  5485.  
  5486.  
  5487.  
  5488.  
  5489.  
  5490.  
  5491.  
  5492.  
  5493.  
  5494.  
  5495.  
  5496.  
  5497.  
  5498.                    - 44     -
  5499.  
  5500.  
  5501.  
  5502.  
  5503.  
  5504.      Syntax:    variable = value;
  5505.  
  5506.      Description:    assigns    value to variable
  5507.      Example:    The following example assigns 3    to
  5508.             register zero, sends an    index to the
  5509.             indexport at 0x3C4 and then writes the
  5510.             contents of the    register to the    dataport
  5511.             at 0x3C5:
  5512.             r0 = 0x03; bout(1,0x3C4,0x3C5);    /* sequencer enable */
  5513.  
  5514.      ____________________________________________________
  5515.      _______________________________________________________
  5516.  
  5517.  
  5518.  
  5519.  
  5520.  
  5521.  
  5522.  
  5523.  
  5524.  
  5525.  
  5526.  
  5527.  
  5528.  
  5529.  
  5530.  
  5531.  
  5532.  
  5533.  
  5534.  
  5535.  
  5536.  
  5537.  
  5538.  
  5539.  
  5540.  
  5541.  
  5542.  
  5543.  
  5544.  
  5545.  
  5546.  
  5547.  
  5548.  
  5549.  
  5550.  
  5551.  
  5552.  
  5553.  
  5554.  
  5555.  
  5556.  
  5557.  
  5558.  
  5559.  
  5560.  
  5561.  
  5562.  
  5563.  
  5564.                    - 45     -
  5565.  
  5566.  
  5567.     X11R4 Server EFS Release and Installation Notes
  5568.  
  5569.  
  5570.      Syntax:    wait(delay);
  5571.  
  5572.      Description:    introduces a delay of delay
  5573.             microseconds.  Use wait    if a short delay
  5574.             is required.
  5575.  
  5576.      ____________________________________________________
  5577.  
  5578.  
  5579.  
  5580.  
  5581.  
  5582.  
  5583.  
  5584.  
  5585.  
  5586.  
  5587.  
  5588.  
  5589.  
  5590.  
  5591.  
  5592.  
  5593.  
  5594.  
  5595.  
  5596.  
  5597.  
  5598.  
  5599.  
  5600.  
  5601.  
  5602.  
  5603.  
  5604.  
  5605.  
  5606.  
  5607.  
  5608.  
  5609.  
  5610.  
  5611.  
  5612.  
  5613.  
  5614.  
  5615.  
  5616.  
  5617.  
  5618.  
  5619.  
  5620.  
  5621.  
  5622.  
  5623.  
  5624.  
  5625.  
  5626.  
  5627.  
  5628.  
  5629.  
  5630.                    - 46     -
  5631.  
  5632.  
  5633.  
  5634.  
  5635.  
  5636.      Syntax:    xor(variable, value);
  5637.  
  5638.      Description:    performs a bitwise exclusive OR    on a
  5639.             variable using the specified value
  5640.  
  5641.      ____________________________________________________
  5642.  
  5643.  
  5644.  
  5645.  
  5646.  
  5647.  
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.  
  5654.  
  5655.  
  5656.  
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.  
  5663.  
  5664.  
  5665.  
  5666.  
  5667.  
  5668.  
  5669.  
  5670.  
  5671.  
  5672.  
  5673.  
  5674.  
  5675.  
  5676.  
  5677.  
  5678.  
  5679.  
  5680.  
  5681.  
  5682.  
  5683.  
  5684.  
  5685.  
  5686.  
  5687.  
  5688.  
  5689.  
  5690.  
  5691.  
  5692.  
  5693.  
  5694.  
  5695.  
  5696.                    - 47     -
  5697.  
  5698.  
  5699.     X11R4 Server EFS Release and Installation Notes
  5700.  
  5701.  
  5702.      0.10  Sample Grafinfo File
  5703.  
  5704. /*
  5705.  * %Z% %M% %I% %E% %Q%
  5706.  *
  5707.  * Copyright (C) 1991 The Santa Cruz Operation, Inc.
  5708.  *
  5709.  * The information in this file is provided for the exclusive use of the
  5710.  * licensees of The Santa Cruz Operation, Inc.  Such users have the right 
  5711.  * to use, modify, and incorporate this code into other products for purposes 
  5712.  * authorized by the license agreement provided they include this notice 
  5713.  * and the associated copyright notice with any such product.  The 
  5714.  * information in this file is provided "AS IS" without warranty.
  5715.  * 
  5716.  */
  5717. /* *********************************************************************** *
  5718.  * IBM/VGA.XGI - XEGIA(tm) GrafInfo File for IBM PS2 VGA Adaptor           *
  5719.  *                                                                         *
  5720.  *        Copyright (c) 1989 Metagraphics Software Corporation             *
  5721.  *      269 Mount Hermon Road, PO 66779, Scotts Valley, CA 95066           *
  5722.  * - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - *
  5723.  *                                                                         *
  5724.  *                      IBM.VGA.VGA.320x200-256                            *
  5725.  *                      IBM.VGA.VGA.640x350-16                             *
  5726.  *                      IBM.VGA.VGA.640x480-2                              *
  5727.  *                      IBM.VGA.VGA.640x480-16                             *
  5728.  *                                                                         *
  5729.  * *********************************************************************** */
  5730.  
  5731. VENDOR IBM         "IBM"
  5732.  MODEL  VGA         "VGA"
  5733.   CLASS  VGA         "VGA"
  5734.    MODE   320x200-256 "320x200 256-color"    /* VGA 320x200 256 color */
  5735.  
  5736.       MEMORY(0xA0000,0x10000);        /*  Base Address, Length        */
  5737.       PORT(0x3C2,0x3CA,0x3CC,0x3DA);  /*  General/External registers  */
  5738.       PORT(0x3C0,0x3C1);              /*  Attribute                   */
  5739.       PORT(0x3C4,0x3C5);              /*  Sequencer                   */
  5740.       PORT(0x3C7,0x3C8,0x3C9);        /*  Color registers             */
  5741.       PORT(0x3CE,0x3CF);              /*  Graphics                    */
  5742.       PORT(0x3D4,0x3D5);              /*  CRTC                        */
  5743.  
  5744.       DATA
  5745.          {
  5746.          XDRIVER     = "dfb";
  5747.          VISUAL      = "PseudoColor";
  5748.          DEPTH       = 8;
  5749.          PIXBYTES    = 320;
  5750.          PIXWIDTH    = 320;
  5751.          PIXHEIGHT   = 200;
  5752.          PIXBITS     = 8;
  5753.          }
  5754.  
  5755.       PROCEDURE  SetGraphics
  5756.          {
  5757.          in(r63,0x3DA);                   /* reset attr F/F  */
  5758.          out(0x3C0,0);                    /* disable palette */
  5759.  
  5760.          r0 = 1;  r1 = 1;  r2 = 0x0F;  r3 = 0;  r4 = 0x0E;
  5761.          bout(5,0x3C4,0x3C5);             /* reset, sequencer regs */
  5762.  
  5763.          out(0x3C2,0x63);                 /* misc out reg */
  5764.          r0=3; bout(1,0x3C4,0x3C5);       /* sequencer enable */
  5765.  
  5766.          out(0x3D4,0x11); out(0x3D5,0);   /* unprotect crtc regs 0-7 */
  5767.          r0  = 0x5F;  r1  = 0x4F;  r2  = 0x50;  r3  = 0x82; /* crtc */
  5768.          r4  = 0x54;  r5  = 0x80;  r6  = 0xBF;  r7  = 0x1F;
  5769.          r8  = 0x00;  r9  = 0x41;  r10 = 0x00;  r11 = 0x00;
  5770.          r12 = 0x00;  r13 = 0x00;  r14 = 0x00;  r15 = 0x00;
  5771.          r16 = 0x9C;  r17 = 0x8E;  r18 = 0x8F;  r19 = 0x28;
  5772.          r20 = 0x40;  r21 = 0x96;  r22 = 0xB9;  r23 = 0xA3;
  5773.          r24 = 0xFF;  bout(25,0x3D4,0x3D5);
  5774.  
  5775.          out(0x3CC,0x00); out(0x3CA,0x01); /* graphics controller */
  5776.          r0  = 0x00;  r1  = 0x00;  r2  = 0x00;  r3  = 0x00;
  5777.          r4  = 0x00;  r5  = 0x40;  r6  = 0x05;  r7  = 0x0F;
  5778.          r8  = 0xFF;  bout(9,0x3CE,0x3CF);
  5779.  
  5780.          in(r63,0x3DA);                   /* reset attr F/F */
  5781.  
  5782.          r0  = 0x00;  r1  = 0x01;  r2  = 0x02;  r3  = 0x03; /* palette */
  5783.          r4  = 0x04;  r5  = 0x05;  r6  = 0x06;  r7  = 0x07;
  5784.          r8  = 0x08;  r9  = 0x09;  r10 = 0x0A;  r11 = 0x0B;
  5785.          r12 = 0x0C;  r13 = 0x0D;  r14 = 0x0E;  r15 = 0x0F;
  5786.  
  5787.          r16 = 0x41;  r17 = 0x00;  r18 = 0x0F;  r19 = 0x00; /* attr cntlr */
  5788.          bout(20,0x3C0,0x3C0);
  5789.  
  5790.          out(0x3C0,0x20);                 /* enable palette */
  5791.          }
  5792.  
  5793.  
  5794.       PROCEDURE SetText
  5795.          {
  5796.          in(r63,0x3DA);                   /* reset attr F/F */
  5797.          out(0x3C0,0);                    /* disable palette */
  5798.  
  5799.          r0 = 0x01;  r1 = 0x00;  r2 = 0x03;  r3 = 0x00;  r4 = 0x02;
  5800.          bout(5,0x3C4,0x3C5);             /* sequencer regs */
  5801.  
  5802.          out(0x3C2,0x67);                 /* misc out reg   */
  5803.          r0=0x03; bout(1,0x3C4,0x3C5);    /* sequencer enable */
  5804.  
  5805.          out(0x3D4,0x11); out(0x3D5,0);   /* unprotect crtc regs 0-7 */
  5806.          r0  = 0x5F;  r1  = 0x4F;  r2  = 0x50;  r3  = 0x82; /* crtc */
  5807.          r4  = 0x55;  r5  = 0x81;  r6  = 0xBF;  r7  = 0x1F;
  5808.          r8  = 0x00;  r9  = 0x4F;  r10 = 0x0D;  r11 = 0x0E;
  5809.          r12 = 0x00;  r13 = 0x00;  r14 = 0x00;  r15 = 0x00;
  5810.          r16 = 0x9C;  r17 = 0x8E;  r18 = 0x8F;  r19 = 0x28;
  5811.          r20 = 0x1F;  r21 = 0x96;  r22 = 0xB9;  r23 = 0xA3;
  5812.          r24 = 0xFF;  bout(25,0x3D4,0x3D5);
  5813.  
  5814.          out(0x3CC,0x00); out(0x3CA,0x01); /* graphics controller */
  5815.          r0  = 0x00;  r1  = 0x00;  r2  = 0x00;  r3  = 0x00;
  5816.          r4  = 0x00;  r5  = 0x10;  r6  = 0x0E;  r7  = 0x00;
  5817.          r8  = 0xFF;  bout(9,0x3CE,0x3CF);
  5818.  
  5819.          in(r63,0x3DA);                   /* reset attr F/F */
  5820.  
  5821.          r0  = 0x00;  r1  = 0x01;  r2  = 0x02;  r3  = 0x03; /* palette    */
  5822.          r4  = 0x04;  r5  = 0x05;  r6  = 0x14;  r7  = 0x07;
  5823.          r8  = 0x38;  r9  = 0x39;  r10 = 0x3A;  r11 = 0x3B;
  5824.          r12 = 0x3C;  r13 = 0x3D;  r14 = 0x3E;  r15 = 0x3F;
  5825.          r16 = 0x0C;  r17 = 0x00;  r18 = 0x0F;  r19 = 0x08; /* attr cntlr */
  5826.          bout(20,0x3C0,0x3C0);
  5827.  
  5828.          out(0x3C0,0x20);                 /* enable palette */
  5829.          }
  5830.  
  5831.  
  5832. /* ********************************************************************* */
  5833.  
  5834. VENDOR IBM         "IBM"
  5835.  MODEL  VGA         "VGA"
  5836.   CLASS  VGA         "VGA"
  5837.    MODE   640x350-16  "640x350 16-color"      /* VGA 640x350 16 color */
  5838.  
  5839.       MEMORY(0xA0000,0x10000);        /*  Base Address, Length        */
  5840.       PORT(0x3C2,0x3CA,0x3CC,0x3DA);  /*  General/External registers  */
  5841.       PORT(0x3C0,0x3C1);              /*  Attribute                   */
  5842.       PORT(0x3C4,0x3C5);              /*  Sequencer                   */
  5843.       PORT(0x3C7,0x3C8,0x3C9);        /*  Color registers             */
  5844.       PORT(0x3CE,0x3CF);              /*  Graphics                    */
  5845.       PORT(0x3D4,0x3D5);              /*  CRTC                        */
  5846.  
  5847.       DATA
  5848.          {
  5849.          XDRIVER     = "mw";
  5850.          VISUAL      = "PseudoColor";
  5851.          DEPTH       = 4;
  5852.          DEVTYPE     = 01;
  5853.          DEVTECH     = 0x0D;            /* VGA */
  5854.          PIXBYTES    = 80;
  5855.          PIXWIDTH    = 640;
  5856.          PIXHEIGHT   = 350;
  5857.          PIXBITS     = 1;
  5858.          PIXPLANES   = 4;
  5859.          MAPTYPE     = "EGA";
  5860.          BASEADDRESS = 0xA0000;
  5861.          INTERLEAVE  = 1;
  5862.          INTERSIZE   = 80;
  5863.          }
  5864.  
  5865.       PROCEDURE  SetGraphics
  5866.          {
  5867.          in(r63,0x3DA);                   /* reset attr F/F  */
  5868.          out(0x3C0,0);                    /* disable palette */
  5869.  
  5870.          r0 = 1;  r1 = 1;  r2 = 0x0F;  r3 = 0;  r4 = 6;
  5871.          bout(6,0x3C4,0x3C5);             /* reset, sequencer regs */
  5872.  
  5873.          out(0x3C2,0xA3);                 /* misc out reg */
  5874.          r0=3; bout(1,0x3C4,0x3C5);       /* sequencer enable */
  5875.  
  5876.          out(0x3D4,0x11); out(0x3D5,0);   /* unprotect crtc regs 0-7 */
  5877.          r0  = 0x5F;  r1  = 0x4F;  r2  = 0x50;  r3  = 0x82; /* crtc */
  5878.          r4  = 0x54;  r5  = 0x80;  r6  = 0xBF;  r7  = 0x1F;
  5879.          r8  = 0x00;  r9  = 0x40;  r10 = 0x00;  r11 = 0x00;
  5880.          r12 = 0x00;  r13 = 0x00;  r14 = 0x00;  r15 = 0x00;
  5881.          r16 = 0x83;  r17 = 0x85;  r18 = 0x5D;  r19 = 0x28;
  5882.          r20 = 0x0F;  r21 = 0x63;  r22 = 0xBA;  r23 = 0xE3;
  5883.          r24 = 0xFF;  bout(25,0x3D4,0x3D5);
  5884.  
  5885.          out(0x3CC,0x00); out(0x3CA,0x01); /* graphics controller */
  5886.          r0  = 0x00;  r1  = 0x00;  r2  = 0x00;  r3  = 0x00;
  5887.          r4  = 0x00;  r5  = 0x00;  r6  = 0x05;  r7  = 0x0F;
  5888.          r8  = 0xFF;  bout(9,0x3CE,0x3CF);
  5889.  
  5890.          in(r63,0x3DA);                   /* reset attr F/F */
  5891.  
  5892.          r0  = 0x00;  r1  = 0x01;  r2  = 0x02;  r3  = 0x03; /* palette */
  5893.          r4  = 0x04;  r5  = 0x05;  r6  = 0x14;  r7  = 0x07;
  5894.          r8  = 0x38;  r9  = 0x39;  r10 = 0x3A;  r11 = 0x3B;
  5895.          r12 = 0x3C;  r13 = 0x3D;  r14 = 0x3E;  r15 = 0x3F;
  5896.  
  5897.          r16 = 0x01;  r17 = 0x00;  r18 = 0x0F;  r19 = 0x00; /* attr cntlr */
  5898.          bout(20,0x3C0,0x3C0);
  5899.  
  5900.          out(0x3C0,0x20);                 /* enable palette */
  5901.          }
  5902.  
  5903.  
  5904.       PROCEDURE SetText
  5905.          {
  5906.          in(r63,0x3DA);                   /* reset attr F/F */
  5907.          out(0x3C0,0);                    /* disable palette */
  5908.  
  5909.          r0 = 0x01;  r1 = 0x00;  r2 = 0x03;  r3 = 0x00;  r4 = 0x02;
  5910.          bout(5,0x3C4,0x3C5);             /* sequencer regs */
  5911.  
  5912.          out(0x3C2,0x67);                 /* misc out reg   */
  5913.          r0=0x03; bout(1,0x3C4,0x3C5);    /* sequencer enable */
  5914.  
  5915.          out(0x3D4,0x11); out(0x3D5,0);   /* unprotect crtc regs 0-7 */
  5916.          r0  = 0x5F;  r1  = 0x4F;  r2  = 0x50;  r3  = 0x82; /* crtc */
  5917.          r4  = 0x55;  r5  = 0x81;  r6  = 0xBF;  r7  = 0x1F;
  5918.          r8  = 0x00;  r9  = 0x4F;  r10 = 0x0D;  r11 = 0x0E;
  5919.          r12 = 0x00;  r13 = 0x00;  r14 = 0x00;  r15 = 0x00;
  5920.          r16 = 0x9C;  r17 = 0x8E;  r18 = 0x8F;  r19 = 0x28;
  5921.          r20 = 0x1F;  r21 = 0x96;  r22 = 0xB9;  r23 = 0xA3;
  5922.          r24 = 0xFF;  bout(25,0x3D4,0x3D5);
  5923.  
  5924.          out(0x3CC,0x00); out(0x3CA,0x01); /* graphics controller */
  5925.          r0  = 0x00;  r1  = 0x00;  r2  = 0x00;  r3  = 0x00;
  5926.          r4  = 0x00;  r5  = 0x10;  r6  = 0x0E;  r7  = 0x00;
  5927.          r8  = 0xFF;  bout(9,0x3CE,0x3CF);
  5928.  
  5929.          in(r63,0x3DA);                   /* reset attr F/F */
  5930.  
  5931.          r0  = 0x00;  r1  = 0x01;  r2  = 0x02;  r3  = 0x03; /* palette    */
  5932.          r4  = 0x04;  r5  = 0x05;  r6  = 0x14;  r7  = 0x07;
  5933.          r8  = 0x38;  r9  = 0x39;  r10 = 0x3A;  r11 = 0x3B;
  5934.          r12 = 0x3C;  r13 = 0x3D;  r14 = 0x3E;  r15 = 0x3F;
  5935.          r16 = 0x0C;  r17 = 0x00;  r18 = 0x0F;  r19 = 0x08; /* attr cntlr */
  5936.          bout(20,0x3C0,0x3C0);
  5937.  
  5938.          out(0x3C0,0x20);                 /* enable palette */
  5939.          }
  5940.  
  5941.  
  5942. /* ********************************************************************* */
  5943.  
  5944. VENDOR IBM         "IBM"
  5945.  MODEL  VGA         "VGA"
  5946.   CLASS  VGA         "VGA"
  5947.    MODE   640x480-2   "640x480 2-color"         /* VGA 640x480 2 color */
  5948.  
  5949.       MEMORY(0xA0000,0x10000);        /* Base Address, Length        */
  5950.       PORT(0x3C2,0x3CA,0x3CC,0x3DA);  /* General/External registers  */
  5951.       PORT(0x3C0,0x3C1);              /* Attribute                   */
  5952.       PORT(0x3C4,0x3C5);              /* Sequencer                   */
  5953.       PORT(0x3CE,0x3CF);              /* Graphics                    */
  5954.       PORT(0x3D4,0x3D5);              /* CRTC                        */
  5955.  
  5956.       DATA
  5957.          {
  5958.          XDRIVER     = "dfb";
  5959.          VISUAL      = "StaticGray";
  5960.          DEPTH       = 1;
  5961.          PIXBYTES    = 80;
  5962.          PIXWIDTH    = 640;
  5963.          PIXHEIGHT   = 480;
  5964.          PIXBITS     = 1;
  5965.          }
  5966.  
  5967.       PROCEDURE SetGraphics
  5968.          {
  5969.          in(r63,0x3DA);                   /* reset attr F/F  */
  5970.          out(0x3C0,0);                    /* disable palette */
  5971.  
  5972.          r0 = 1;  r1 = 1;  r2 = 0x0F;  r3 = 0;  r4 = 6;
  5973.          bout(5,0x3C4,0x3C5);             /* reset, sequencer regs */
  5974.  
  5975.          out(0x3C2,0xE3);                 /* misc out reg */
  5976.          r0=3;  bout(1,0x3C4,0x3C5);      /* sequencer enable */
  5977.  
  5978.          out(0x3D4,0x11); out(0x3D5,0);   /* unprotect crtc regs 0-7 */
  5979.          r0  = 0x5F;  r1  = 0x4F;  r2  = 0x50;  r3  = 0x82; /* crtc */
  5980.          r4  = 0x54;  r5  = 0x80;  r6  = 0x0B;  r7  = 0x3E;
  5981.          r8  = 0x00;  r9  = 0x40;  r10 = 0x00;  r11 = 0x00;
  5982.          r12 = 0x00;  r13 = 0x00;  r14 = 0x00;  r15 = 0x00;
  5983.          r16 = 0xEA;  r17 = 0x8C;  r18 = 0xDF;  r19 = 0x28;
  5984.          r20 = 0x00;  r21 = 0xE7;  r22 = 0x04;  r23 = 0xC3;
  5985.          r24 = 0xFF;  bout(25,0x3D4,0x3D5);
  5986.  
  5987.          out(0x3CC,0x00); out(0x3CA,0x01); /* graphics controller */
  5988.          r0  = 0x00;  r1  = 0x00;  r2  = 0x00;  r3  = 0x00;
  5989.          r4  = 0x00;  r5  = 0x00;  r6  = 0x05;  r7  = 0x01;
  5990.          r8  = 0xFF;  bout(9,0x3CE,0x3CF);
  5991.  
  5992.          in(r63,0x3DA);                   /* reset attribute flip/flop */
  5993.  
  5994.          r0  = 0x00;  r1  = 0x3F;  r2  = 0x3F;  r3  = 0x3F; /* palette */
  5995.          r4  = 0x3F;  r5  = 0x3F;  r6  = 0x3F;  r7  = 0x3F;
  5996.          r8  = 0x3F;  r9  = 0x3F;  r10 = 0x3F;  r11 = 0x3F;
  5997.          r12 = 0x3F;  r13 = 0x3F;  r14 = 0x3F;  r15 = 0x3F;
  5998.          r16 = 0x01;  r17 = 0x00;  r18 = 0x01;  r19 = 0x00; /* attr cntlr */
  5999.          bout(20,0x3C0,0x3C0);
  6000.  
  6001.          out(0x3C0,0x20);                 /* enable palette */
  6002.          }
  6003.  
  6004.       PROCEDURE SetText
  6005.          {
  6006.          in(r63,0x3DA);                   /* reset attr F/F */
  6007.          out(0x3C0,0);                    /* disable palette */
  6008.  
  6009.          r0 = 0x01;  r1 = 0x00;  r2 = 0x03;  r3 = 0x00;  r4 = 0x02;
  6010.          bout(5,0x3C4,0x3C5);             /* sequencer regs */
  6011.  
  6012.          out(0x3C2,0x67);                 /* misc out reg   */
  6013.          r0=0x03; bout(1,0x3C4,0x3C5);    /* sequencer enable */
  6014.  
  6015.          out(0x3D4,0x11); out(0x3D5,0);   /* unprotect crtc regs 0-7 */
  6016.          r0  = 0x5F;  r1  = 0x4F;  r2  = 0x50;  r3  = 0x82; /* crtc */
  6017.          r4  = 0x55;  r5  = 0x81;  r6  = 0xBF;  r7  = 0x1F;
  6018.          r8  = 0x00;  r9  = 0x4F;  r10 = 0x0D;  r11 = 0x0E;
  6019.          r12 = 0x00;  r13 = 0x00;  r14 = 0x00;  r15 = 0x00;
  6020.          r16 = 0x9C;  r17 = 0x8E;  r18 = 0x8F;  r19 = 0x28;
  6021.          r20 = 0x1F;  r21 = 0x96;  r22 = 0xB9;  r23 = 0xA3;
  6022.          r24 = 0xFF;  bout(25,0x3D4,0x3D5);
  6023.  
  6024.          out(0x3CC,0x00); out(0x3CA,0x01); /* graphics controller */
  6025.          r0  = 0x00;  r1  = 0x00;  r2  = 0x00;  r3  = 0x00;
  6026.          r4  = 0x00;  r5  = 0x10;  r6  = 0x0E;  r7  = 0x00;
  6027.          r8  = 0xFF;  bout(9,0x3CE,0x3CF);
  6028.  
  6029.          in(r63,0x3DA);                   /* reset attr F/F */
  6030.  
  6031.          r0  = 0x00;  r1  = 0x01;  r2  = 0x02;  r3  = 0x03; /* palette    */
  6032.          r4  = 0x04;  r5  = 0x05;  r6  = 0x14;  r7  = 0x07;
  6033.          r8  = 0x38;  r9  = 0x39;  r10 = 0x3A;  r11 = 0x3B;
  6034.          r12 = 0x3C;  r13 = 0x3D;  r14 = 0x3E;  r15 = 0x3F;
  6035.          r16 = 0x0C;  r17 = 0x00;  r18 = 0x0F;  r19 = 0x08; /* attr cntlr */
  6036.          bout(20,0x3C0,0x3C0);
  6037.  
  6038.          out(0x3C0,0x20);                 /* enable palette */
  6039.          }
  6040.  
  6041.  
  6042. /* ********************************************************************* */
  6043.  
  6044. VENDOR IBM         "IBM"
  6045.  MODEL  VGA         "VGA"
  6046.   CLASS  VGA         "VGA"
  6047.    MODE   640x480-16  "640x480 16-color"         /* VGA 640x480 16 color */
  6048.  
  6049.       MEMORY(0xA0000,0x10000);        /* Base Address, Length        */
  6050.       PORT(0x3C2,0x3CA,0x3CC,0x3DA);  /* General/External registers  */
  6051.       PORT(0x3C0,0x3C1);              /* Attribute                   */
  6052.       PORT(0x3C4,0x3C5);              /* Sequencer                   */
  6053.       PORT(0x3C7,0x3C8,0x3C9);        /* Color registers             */
  6054.       PORT(0x3CE,0x3CF);              /* Graphics                    */
  6055.       PORT(0x3D4,0x3D5);              /* CRTC                        */
  6056.  
  6057.       DATA
  6058.          {
  6059.          XDRIVER     = "mw";
  6060.          VISUAL      = "PseudoColor";
  6061.          DEPTH       = 4;
  6062.          DEVTYPE     = 01;
  6063.          DEVTECH     = 0x0D;            /* VGA */
  6064.          PIXBYTES    = 80;
  6065.          PIXWIDTH    = 640;
  6066.          PIXHEIGHT   = 480;
  6067.          PIXBITS     = 1;
  6068.          PIXPLANES   = 4;
  6069.          MAPTYPE     = "EGA";
  6070.          BASEADDRESS = 0xA0000;
  6071.          INTERLEAVE  = 1;
  6072.          INTERSIZE   = 80;
  6073.          }
  6074.  
  6075.       PROCEDURE SetGraphics
  6076.          {
  6077.          in(r63,0x3DA);                   /* reset attr F/F  */
  6078.          out(0x3C0,0);                    /* disable palette */
  6079.  
  6080.          r0 = 1;  r1 = 1;  r2 = 0x0F;  r3 = 0;  r4 = 6;
  6081.          bout(5,0x3C4,0x3C5);             /* reset, sequencer regs */
  6082.  
  6083.          out(0x3C2,0xE3);                 /* misc out reg */
  6084.          r0=3;  bout(1,0x3C4,0x3C5);      /* sequencer enable */
  6085.  
  6086.          out(0x3D4,0x11); out(0x3D5,0);   /* unprotect crtc regs 0-7 */
  6087.          r0  = 0x5F;  r1  = 0x4F;  r2  = 0x50;  r3  = 0x82; /* crtc */
  6088.          r4  = 0x54;  r5  = 0x80;  r6  = 0x0B;  r7  = 0x3E;
  6089.          r8  = 0x00;  r9  = 0x40;  r10 = 0x00;  r11 = 0x00;
  6090.          r12 = 0x00;  r13 = 0x00;  r14 = 0x00;  r15 = 0x00;
  6091.          r16 = 0xEA;  r17 = 0x8C;  r18 = 0xDF;  r19 = 0x28;
  6092.          r20 = 0x00;  r21 = 0xE7;  r22 = 0x04;  r23 = 0xE3;
  6093.          r24 = 0xFF;  bout(25,0x3D4,0x3D5);
  6094.  
  6095.          out(0x3CC,0x00); out(0x3CA,0x01); /* graphics controller */
  6096.          r0  = 0x00;  r1  = 0x00;  r2  = 0x00;  r3  = 0x00;
  6097.          r4  = 0x00;  r5  = 0x00;  r6  = 0x05;  r7  = 0x0F;
  6098.          r8  = 0xFF;  bout(9,0x3CE,0x3CF);
  6099.  
  6100.          in(r63,0x3DA);                   /* reset attribute flip/flop */
  6101.  
  6102.          r0  = 0x00;  r1  = 0x01;  r2  = 0x02;  r3  = 0x03; /* palette */
  6103.          r4  = 0x04;  r5  = 0x05;  r6  = 0x14;  r7  = 0x07;
  6104.          r8  = 0x38;  r9  = 0x39;  r10 = 0x3A;  r11 = 0x3B;
  6105.          r12 = 0x3C;  r13 = 0x3D;  r14 = 0x3E;  r15 = 0x3F;
  6106.          r16 = 0x01;  r17 = 0x00;  r18 = 0x0F;  r19 = 0x00; /* attr cntlr */
  6107.          bout(20,0x3C0,0x3C0);
  6108.  
  6109.          out(0x3C0,0x20);                 /* enable palette */
  6110.          }
  6111.  
  6112.       PROCEDURE SetText
  6113.          {
  6114.          in(r63,0x3DA);                   /* reset attr F/F */
  6115.          out(0x3C0,0);                    /* disable palette */
  6116.  
  6117.          r0 = 0x01;  r1 = 0x00;  r2 = 0x03;  r3 = 0x00;  r4 = 0x02;
  6118.          bout(5,0x3C4,0x3C5);             /* sequencer regs */
  6119.  
  6120.          out(0x3C2,0x67);                 /* misc out reg   */
  6121.          r0=0x03; bout(1,0x3C4,0x3C5);    /* sequencer enable */
  6122.  
  6123.          out(0x3D4,0x11); out(0x3D5,0);   /* unprotect crtc regs 0-7 */
  6124.          r0  = 0x5F;  r1  = 0x4F;  r2  = 0x50;  r3  = 0x82; /* crtc */
  6125.          r4  = 0x55;  r5  = 0x81;  r6  = 0xBF;  r7  = 0x1F;
  6126.          r8  = 0x00;  r9  = 0x4F;  r10 = 0x0D;  r11 = 0x0E;
  6127.          r12 = 0x00;  r13 = 0x00;  r14 = 0x00;  r15 = 0x00;
  6128.          r16 = 0x9C;  r17 = 0x8E;  r18 = 0x8F;  r19 = 0x28;
  6129.          r20 = 0x1F;  r21 = 0x96;  r22 = 0xB9;  r23 = 0xA3;
  6130.          r24 = 0xFF;  bout(25,0x3D4,0x3D5);
  6131.  
  6132.          out(0x3CC,0x00); out(0x3CA,0x01); /* graphics controller */
  6133.          r0  = 0x00;  r1  = 0x00;  r2  = 0x00;  r3  = 0x00;
  6134.          r4  = 0x00;  r5  = 0x10;  r6  = 0x0E;  r7  = 0x00;
  6135.          r8  = 0xFF;  bout(9,0x3CE,0x3CF);
  6136.  
  6137.          in(r63,0x3DA);                   /* reset attr F/F */
  6138.  
  6139.          r0  = 0x00;  r1  = 0x01;  r2  = 0x02;  r3  = 0x03; /* palette    */
  6140.          r4  = 0x04;  r5  = 0x05;  r6  = 0x14;  r7  = 0x07;
  6141.          r8  = 0x38;  r9  = 0x39;  r10 = 0x3A;  r11 = 0x3B;
  6142.          r12 = 0x3C;  r13 = 0x3D;  r14 = 0x3E;  r15 = 0x3F;
  6143.          r16 = 0x0C;  r17 = 0x00;  r18 = 0x0F;  r19 = 0x08; /* attr cntlr */
  6144.          bout(20,0x3C0,0x3C0);
  6145.  
  6146.          out(0x3C0,0x20);                 /* enable palette */
  6147.          }
  6148.  
  6149. /* End of File - IBM/VGA.XGI */
  6150.